render.categorical.default: Render categorical values for table output.

Description Usage Arguments Value Examples

View source: R/table1.R

Description

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

Usage

1
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

1
2
3
y <- factor(sample(0:1, 99, replace=TRUE), labels=c("Female", "Male"))
y[1:10] <- NA
render.categorical.default(y)

Example output

Attaching package:table1The following objects are masked frompackage:base:

    units, units<-

                   Female         Male 
          "" "51 (51.5%)" "38 (38.4%)" 

table1 documentation built on June 7, 2021, 1:07 a.m.