The labels function extracts all assigned labels from a
data frame, and returns them in a named list. The function also
assigns labels from a named list. This function is a data frame-specific
implementation of the Base R labels function.
# S3 method for data.frame labels(object, ...) labels(x) <- value
| object | A data frame or tibble. |
|---|---|
| ... | Follow-on parameters. Required for generic function. |
| x | A data frame or tibble |
| value | A named list of labels The labels must be quoted strings. |
A named list of labels. The labels must be quoted strings.
If labels are assigned to the "label" attributes of the data frame
columns, the labels function will extract those labels. The
function will return the labels in a named list, where the names
correspond to the name of the column that the label was assigned to.
If a column does not have a label attribute assigned, that column
will not be included in the list.
When used on the receiving side of an assignment, the function will assign labels to a data frame. The labels should be in a named list, where each name corresponds to the data frame column to assign the label to.
Finally, if you wish to clear out the label attributes, assign
a NULL value to the labels function.
fdata to display formatted data,
value to create user-defined formats, and
fapply to apply formats to a vector.
# Take subset of data df1 <- mtcars[1:10, c("mpg", "cyl") ] # Assign labels labels(df1) <- list(mpg = "Mile Per Gallon", cyl = "Cylinders") # Examine attributes str(df1) # View assigned labels labels(df1) # Clear labels labels(df1) <- NULL # Display Cleared Labels labels(df1)