haven (version 2.2.0)

as_factor: Convert input to a factor.

Description

The base function as.factor() is not a generic, but this variant is. Methods are provided for factors, character vectors, labelled vectors, and data frames. By default, when applied to a data frame, it only affects labelled columns.

Usage

# S3 method for data.frame
as_factor(x, ..., only_labelled = TRUE)
# S3 method for haven_labelled
as_factor(x, levels = c("default", "labels",
  "values", "both"), ordered = FALSE, ...)
# S3 method for labelled
as_factor(x, levels = c("default", "labels", "values",
  "both"), ordered = FALSE, ...)

Arguments

x

Object to coerce to a factor.

...

Other arguments passed down to method.

only_labelled

Only apply to labelled columns?

levels

How to create the levels of the generated factor:

• "default": uses labels where available, otherwise the values. Labels are sorted by value.

• "both": like "default", but pastes together the level and value

• "label": use only the labels; unlabelled values become NA

• "values: use only the values

ordered

If TRUE create an ordered (ordinal) factor, if FALSE (the default) create a regular (nominal) factor.

Details

Includes methods for both class haven_labelled and labelled for backward compatibility.

Examples

# NOT RUN {
x <- labelled(sample(5, 10, replace = TRUE), c(Bad = 1, Good = 5))

# Default method uses values where available
as_factor(x)
# You can also extract just the labels
as_factor(x, levels = "labels")
# Or just the values
as_factor(x, levels = "values")
# Or combine value and label
as_factor(x, levels = "both")
# }