Format an integer as a string

formatInt(
  x,
  big.mark = ",",
  trim = TRUE,
  forceInteger = TRUE,
  scientific = FALSE,
  ...
)

Arguments

x

numeric vector or matrix

big.mark, trim, scientific

options sent to base::format() but configured with defaults intended for integer values.

forceInteger

logical indicating whether numeric values should be rounded to the nearest integer value prior to base::format(). This option is intended to hide decimal values where they are not informative.

Value

character vector if x is a vector, or if x is a matrix a matrix will be returned.

Details

This function is a quick wrapper function around base::format() to display integer values as text strings. It will also return a matrix if the input is a matrix.

Examples

x <- c(1234, 1234.56, 1234567.89);
## By default, commas are used for big.mark, and decimal values are hidden
formatInt(x);
#> [1] "1,234"     "1,235"     "1,234,568"

## By default, commas are used for big.mark
formatInt(x, forceInteger=FALSE);
#> [1] "1,234.00"     "1,234.56"     "1,234,567.89"