R: Convert vector to labelled class

as_labelled {sjlabelled} | R Documentation

## Convert vector to labelled class

### Description

Converts a (labelled) vector of any class into a `labelled` class vector, resp. adds a `labelled` class-attribute.

### Usage

    as_labelled(x, add.labels = FALSE, add.class = FALSE)

### Arguments

`x` | Variable (vector), `data.frame` or `list` of variables that should be converted to `labelled`-class objects.
`add.labels` | Logical, if `TRUE`, non-labelled values will be labelled with the corresponding value.
`add.class` | Logical, if `TRUE`, `x` preserves its former `class`-attribute and `labelled` is added as additional attribute. If `FALSE` (default), all former `class`-attributes will be removed and the class-attribute of `x` will only be `labelled`.

### Value

`x`, as `labelled`-class object.

### Examples

    data(efc)
    str(efc$e42dep)

    x <- as_labelled(efc$e42dep)
    str(x)

    x <- as_labelled(efc$e42dep, add.class = TRUE)
    str(x)

    a <- c(1, 2, 4)
    x <- as_labelled(a, add.class = TRUE)
    str(x)

    data(efc)
    x <- set_labels(efc$e42dep,
                    labels = c(`1` = "independent", `4` = "severe dependency"))
    x1 <- as_labelled(x, add.labels = FALSE)
    x2 <- as_labelled(x, add.labels = TRUE)

    str(x1)
    str(x2)

    get_values(x1)
    get_values(x2)

[Package sjlabelled version 1.0.11 Index]