Render categorical values for table output.

Source: R/table1.R

Called from table1 by default to render categorical (i.e. factor, character or logical) values for displaying in the table.

render.categorical.default(x, ..., na.is.category = TRUE)

Arguments

x

A vector of type factor, character or logical.

...

Further arguments, passed to stats.apply.rounding.

na.is.category

Include missing values in the denominator for calculating percentages (the default) or omit them.

Value

A character vector. Each element is to be displayed in a separate cell in the table. The names of the vector are the labels to use in the table. However, the first names should be empty as it will be replaced by the name of the variable. Empty strings are allowed and result in empty table cells.

Examples

y <- factor(sample(0:1, 99, replace=TRUE), labels=c("Female", "Male"))
y[1:10] <- NA
render.categorical.default(y)
#>                    Female         Male 
#>           "" "52 (52.5%)" "37 (37.4%)"