labelled: to_character – R documentation

Become an expert in R — Interactive courses, Cheat Sheets, certificates and more!

to_character

Convert input to a character vector

Description

By default, to_character() is a wrapper for base::as.character(). For labelled vector, to_character allows to specify if value, labels or labels prefixed with values should be used for conversion.

Usage

to_character(x, ...)

## S3 method for class 'haven_labelled'
to_character(
  x,
  levels = c("labels", "values", "prefixed"),
  nolabel_to_na = FALSE,
  user_na_to_na = FALSE,
  ...
)

Arguments

`x`	Object to coerce to a character vector.
`...`	Other arguments passed down to method.
`levels`	What should be used for the factor levels: the labels, the values or labels prefixed with values?
`nolabel_to_na`	Should values with no label be converted to `NA`?
`user_na_to_na`	user defined missing values into NA?

Details

If some values doesn't have a label, automatic labels will be created, except if nolabel_to_na is TRUE.

Examples

v <- labelled(c(1,2,2,2,3,9,1,3,2,NA), c(yes = 1, no = 3, "don't know" = 9))
to_character(v)
to_character(v, nolabel_to_na = TRUE)
to_character(v, "v")
to_character(v, "p")

labelled

Manipulating Labelled Data

v2.8.0

GPL-3

Authors

Joseph Larmarange [aut, cre] (<https://orcid.org/0000-0001-7097-700X>), Daniel Ludecke [ctb], Hadley Wickham [ctb], Michal Bojanowski [ctb], François Briatte [ctb]

Initial release