as_string: Convert Vectors to Strings or Formatted Representations

In exams.forge: Support for Compiling Examination Tasks using the 'exams' Package

Convert Vectors to Strings or Formatted Representations

Description

These functions convert vectors into human-readable string representations. They can join elements, create LaTeX-formatted fractions, or label observations.

Usage

as_string(txt, collapse = ", ", last = ", and ")

as_sum(txt)

as_obs(txt, name = "x", sorted = FALSE, ...)

as_fraction(val, latex = FALSE, sorted = FALSE, ...)

lobs(txt, name = "x", sorted = FALSE, ...)

lstring(txt, collapse = ", ", last = ", and ")

lfrac(val, latex = FALSE, sorted = FALSE, ...)

Arguments

txt	Character vector to merge into a single string (used in as_string, as_obs).
collapse	Character string inserted between elements (default: ", ").
last	Character string used between the last two elements (default: ", and ").
name	Character string used as the observation name (default: "x"; used in as_obs).
sorted	Logical; if TRUE, sort the vector before conversion (default: FALSE).
...	Additional arguments passed to underlying functions.
val	Numeric vector of values to convert into fractions (used in as_fraction).
latex	Logical; if TRUE, returns fractions in LaTeX format \frac{.}{.} (default: FALSE; used in as_fraction).

Value

A single string, or a vector of formatted strings (for fractions in as_fraction).

Examples

x <- runif(5)
y <- c(TRUE, FALSE, NA)

# Basic string conversion
as_string(x)
as_string(y)
as_string(as.character(x))
as_string(as.character(y))

# Observations
as_obs(x)
as_obs(sort(x), sorted = TRUE)

# Fraction conversion
x <- round(runif(5), 2)
as_fraction(x)
as_fraction(x, latex = TRUE)

# Summing elements as a string
y <- round(runif(5), 2)
as_sum(y)

exams.forge documentation built on Aug. 21, 2025, 5:41 p.m.