xpssAddValueLabels: Modifies value labels

In translateSPSS2R: Toolset for Translating SPSS-Syntax to R-Code

Description

R implementation of the SPSS ADD VALUE LABELS function. xpssAddValueLabels appends value labels for specific variables. Those values labels get stored in the attributes of the selected variable.

Usage

xpssAddValueLabels(x, variables = NULL, values = NULL, labels = NULL,
  datevariables = NULL, datevalues = NULL, datelabels = NULL)

Arguments

x	a (non-empty) data.frame or input data of class "xpssFrame".
variables	atomic character or character vector with the name of the variables.
values	atomic numeric or numeric vector, respectively as an atomic character or character vector containing the value of the variable.
labels	atomic numeric or numeric vector, respectively as an atomic character or character vector containing the label of the variable.
datevariables	atomic date or date vector with the name of the date variables.
datevalues	atomic date or date vector containing the value of the date, the value has to be like the old date format.
datelabels	atomic numeric or numeric vector, respectively as an atomic character or character vector containing a variable label.

Details

The values labels are stored in the variable itself.
In contrast to xpssValueLabels , xpssAddValueLabels do not erase existing value labels.
If the value label for a specific variable already exists, this value label get overwritten.
If the value label for a specific variable does not exist, the value label get created without deleting the existing value label of that variable.

Supported attributes are: value.labels, defined.MIS, MIS, varname, variable.label

Value

An xpssFrame object with modified value labels.

Author(s)

Bastian Wiessner

See Also

read.spss xpssValueLabels xpssVariableLabels

Examples

data(fromXPSS)

fromXPSS <- xpssValueLabels(fromXPSS,
                           variables = "V1",
                           values = 1 ,
                           labels = "Label1")

fromXPSS <- xpssAddValueLabels(fromXPSS,
                           variables = "V1",
                           values = 2 ,
                           labels = "Label2")

fromXPSS <- xpssAddValueLabels(fromXPSS,
                           variables = "V1",
                           values = "B" ,
                           labels = "CharLabel")



attributes(fromXPSS$V1)$value.labels

translateSPSS2R documentation built on May 30, 2017, 4:31 a.m.