headl {labelr}

Return First Rows of a Data Frame with Value Labels Visible

Description

headl accepts a labelr value-labeled data.frame and returns the first n value-labeled rows of that data.frame

Usage

headl(data, n = 6L)

Arguments

data

a data.frame.

n

the last row to select (i.e., rows 1 through n will be returned).

Details

Whereas utils::head returns the first n rows of a data.frame, headl does the same thing, substituting value labels for values wherever the former exist. See also taill and somel.

Value

a data.frame.

Examples

# make toy demographic (gender, raceth, etc.) data set
set.seed(555)
df <- make_demo_data(n = 1000) # another labelr:: function
# let's add variable VALUE labels for variable "raceth"
df <- add_val_labs(df,
  vars = "raceth", vals = c(1:7),
  labs = c("White", "Black", "Hispanic", "Asian", "AIAN", "Multi", "Other"),
  max.unique.vals = 50
)

# let's add variable VALUE labels for variable "gender"
# note that, if we are labeling a single variable, we can use add_val1()
# distinction between add_val1() and add_val_labs() will become more meaningful
# when we get to our Likert example
df <- add_val1(
  data = df, gender, vals = c(0, 1, 2, 3, 4),
  labs = c("M", "F", "TR", "NB", "Diff-Term"), max.unique.vals = 50
)

head(df) # utils::head
headl(df) # same, but with value labels in place of values