rcell: Cell value constructors
In rtables: Reporting Tables

rcell

R Documentation

Cell value constructors

Description

Construct a cell value and associate formatting, labeling, indenting, and column spanning information with it.

Usage

rcell(
  x,
  format = NULL,
  colspan = 1L,
  label = NULL,
  indent_mod = NULL,
  footnotes = NULL,
  align = NULL,
  format_na_str = NULL
)

non_ref_rcell(
  x,
  is_ref,
  format = NULL,
  colspan = 1L,
  label = NULL,
  indent_mod = NULL,
  refval = NULL,
  align = "center",
  format_na_str = NULL
)

Arguments

`x`	ANY. Cell value.
`format`	character(1) or function. The format label (string) or `formatters` function to apply to `x`. See `formatters::list_valid_format_labels()` for currently supported format labels.
`colspan`	integer(1). Column span value.
`label`	character(1). Label or `NULL`. If non-null, it will be looked at when determining row labels.
`indent_mod`	numeric. Modifier for the default indent position for the structure created by this function(subtable, content table, or row) and all of that structure's children. Defaults to 0, which corresponds to the unmodified default behavior.
`footnotes`	list or `NULL`. Referential footnote messages for the cell.
`align`	character(1) or `NULL`. Alignment the value should be rendered with. It defaults to `"center"` if `NULL` is used. See `formatters::list_valid_aligns()` for currently supported alignments.
`format_na_str`	character(1). String which should be displayed when formatted if this cell's value(s) are all NA.
`is_ref`	logical(1). Are we in the reference column (i.e. .in_ref_col should be passed to this argument)
`refval`	ANY. Value to use when in the reference column. Defaults to `NULL`

Details

non_ref_rcell provides the common blank for cells in the reference column, this value otherwise, and should be passed the value of .in_ref_col when it is used.

Value

An object representing the value within a single cell within a populated table. The underlying structure of this object is an implementation detail and should not be relied upon beyond calling accessors for the class.