The widths function extracts all assigned widths from a data frame, and returns them in a named list. The function also assigns widths from a named list.

widths(x)

widths(x) <- value

Arguments

x A data frame or tibble A named list of widths. The widths must be positive integers greater than zero.

Value

A named list of widths. The widths must be positive integers greater than zero.

Details

If widths are assigned to the "width" attributes of the data frame columns, the widths function will extract those widths. The function will return the widths in a named list, where the names correspond to the name of the column that the width was assigned to. If a column does not have a width attribute assigned, that column will not be included in the list.

When used on the receiving side of an assignment, the function will assign widths to a data frame. The widths should be in a named list, where each name corresponds to the data frame column to assign the width to.

Finally, if you wish to clear out the width attributes, assign a NULL value to the widths function.

fdata to display formatted data, value to create user-defined formats, and fapply to apply formats to a vector.

Examples

# Take subset of data
df1 <- mtcars[1:10, c("mpg", "cyl") ]

# Print current state
print(df1)

# Assign widths
widths(df1) <- list(mpg = 12, cyl = 10)

# Display formatted data
fdata(df1)

# View assigned widths
widths(df1)

# Clear widths
widths(df1) <- NULL

# Confirm widths are cleared
widths(df1)