has_avl_labs: Is This a 'add_val_labs()'-style Value-labeled Variable...

In labelr: Label Data Frames, Variables, and Values

Is This a add_val_labs()-style Value-labeled Variable (Column)?

Description

Determine whether a specific variable of a data.frame has value labels associated with it that were added using add_val_labs() or add_val1().

Usage

has_avl_labs(data, var)

h11l(data, var)

hql(data, var)

Arguments

data	a data.frame.
var	the unquoted name of the variable (column) to check for the presence of add_val_labs()-style (one-to-one) value labels.

Details

h11l is a compact alias for has_avl_labs: they do the same thing, and the former is easier to type

Value

A 1L logical.

Examples

# add val labs to multiple variables at once
# make a "Likert"-type fake data set to demo
# note, by default, add_val_labs() "vars" arg will do partial matching
# in this case, we catch all vars with "y" in their name, except "y3"
set.seed(272)
dflik <- make_likert_data(scale = 1:7)
vals2label <- 1:7
labs2use <- c(
  "VSD",
  "SD",
  "D",
  "N",
  "A",
  "SA",
  "VSA"
)

dflik <- add_val_labs(
  data = dflik, vars = c("y"), # note the vars args
  not.vars = "y3",
  vals = vals2label,
  labs = labs2use,
  partial = TRUE
)

has_avl_labs(dflik, y1) # TRUE

has_avl_labs(dflik, y3) # FALSE, see not.vars arg above

labelr documentation built on Sept. 11, 2024, 9:05 p.m.