labelr (version 0.1.9)

drop_val1: Drop a Single Variable's Value Labels

Description

Drop all value labels previously applied to one or more variables using add_val_labs, add_quant_labs,add_m1_lab, and related functions (e.g., add_val1) or aliases (e.g., avl).

Note: dvl1 is a compact alias for drop_val1: they do the same thing, and the former is easier to type

Usage

drop_val1(data, var)
dvl1(data, var)

Value

A data.frame, with all value labels dropped from specified variable.

Arguments

data

a data.frame.

var

the unquoted name of the variable whose value labels will be dropped.

Details

Note: drop_val1 is the drop_val_labs analogue to add_val1: just as add_val1 is a variant of add_val_labs that allows you to specify only one variable at a time unquoted for value labeling, drop_val1 allows you to pass one unquoted variable name at a time for value dropping. See those functions for further details regarding the conventions.

Examples

# 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 "x" in their name
set.seed(272)
dflik <- make_likert_data(scale = 1:7)
vals2label <- 1:7
labs2use <- c(
  "VSD",
  "SD",
  "D",
  "N",
  "A",
  "SA",
  "VSA"
)

dflik <- add_val1(
  data = dflik, var = x3,
  vals = vals2label,
  labs = labs2use
)

# see what this did
get_val_labs(dflik, "x3")

dfdrop <- drop_val1(dflik,
  var = x3
) # odd choice, but ok

# var x3's value labels are gone, like we asked for
get_val_labs(dfdrop, "x3")