rlistings (version 0.2.9)

listing_methods: Methods for listing_df objects

Description

See core documentation in formatters::formatters-package for descriptions of these functions.

Usage

# S3 method for listing_df
print(
  x,
  widths = NULL,
  tf_wrap = FALSE,
  max_width = NULL,
  fontspec = NULL,
  col_gap = 3L,
  ...
)
# S4 method for listing_df
toString(x, widths = NULL, fontspec = NULL, col_gap = 3L, ...)
# S4 method for listing_df
[(x, i, j, drop = FALSE)
# S4 method for listing_df
main_title(obj)
# S4 method for listing_df
subtitles(obj)
# S4 method for listing_df
main_footer(obj)
# S4 method for listing_df
prov_footer(obj)
# S4 method for listing_df
main_title(obj) <- value
# S4 method for listing_df
subtitles(obj) <- value
# S4 method for listing_df
main_footer(obj) <- value
# S4 method for listing_df
prov_footer(obj) <- value
# S4 method for listing_df
num_rep_cols(obj)

Value

• Accessor methods return the value of the aspect of obj.

• Setter methods return obj with the relevant element of the listing updated.

Arguments

x

(listing_df)
the listing.

widths

(numeric or NULL)
Proposed widths for the columns of x. The expected length of this numeric vector can be retrieved with ncol(x) + 1 as the column of row names must also be considered.

tf_wrap

(flag)
whether the text for title, subtitles, and footnotes should be wrapped.

max_width

(integer(1), string or NULL)
width that title and footer (including footnotes) materials should be word-wrapped to. If NULL, it is set to the current print width of the session (getOption("width")). If set to "auto", the width of the table (plus any table inset) is used. Parameter is ignored if tf_wrap = FALSE.

fontspec

(font_spec)
a font_spec object specifying the font information to use for calculating string widths and heights, as returned by font_spec().

col_gap

(numeric(1))
space (in characters) between columns.

...

additional parameters passed to formatters::toString().

i

(any)
object passed to base [ methods.

j

(any)
object passed to base [ methods.

drop

For matrices and arrays. If TRUE the result is coerced to the lowest possible dimension (see the examples). This only works for extracting elements, not for the replacement. See drop for further details.

obj

(listing_df)
the listing.

value

typically an array-like R object of a similar class as x.

Examples

lsting <- as_listing(mtcars)
main_title(lsting) <- "Hi there"

main_title(lsting)