Returns a character representation of a labelled variable, using the value labels to look up the label for a given value.
The default behavior of this function is similar to
labelled::to_character()
. The options, however, are slightly different.
Most importantly, instead of specifying NA
handling using parameters, the
function relies on the default
parameter to determine what happens for
unlabelled variables, allowing users to specify including the original values
of x
instead of the labels, returning NA
, or returning a specific string
value. Also, the default behavior is to drop any variable label attribute, in
line with the default as.character()
method.
ll_to_character(x, default = x, preserve_var_label = FALSE)
A labelled variable
Vector providing a default label for any values not found in
the val_labels
(unlabelled values). Must be of length 1 or of the same
length as x. Useful possibilities are x
(use values where labels are not
found), NA
(return NA for such values), and ""
(an empty string).
Missing (NA
) values in x
, however, are never replaced with the default,
they remain NA
.
Should any var_label
in x be preserved, or
should they be dropped from the result (ensuring that the result is bare
and without any attributes).
Other labelled light:
ll_assert_labelled()
,
ll_labelled()
,
ll_val_labels()
,
ll_var_label()
,
threadbare()