assert_character_vector_or_glue: Assert input is a character vector / glue vector

In assertions: Simple Assertions for Beautiful and Customisable Error Messages

Assert input is a character vector / glue vector

Description

Assert an object is a character vector (or a glue vector). Length 1 character vectors (strings) are considered vectors.

Usage

assert_character_vector_or_glue(
  x,
  msg = NULL,
  call = rlang::caller_env(),
  arg_name = NULL
)

Arguments

x	An object
msg	A character string containing the error message to display if x is not a character vector
call	Only relevant when pooling assertions into multi-assertion helper functions. See cli_abort for details.
arg_name	Advanced use only. Name of the argument passed (default: NULL, will automatically extract arg_name).

Value

invisible(TRUE) if x is a character vector, otherwise aborts with the error message specified by msg

Examples

try({
assert_character_vector_or_glue(c("a", "b", "c")) # Passes
assert_character_vector_or_glue(glue::glue('A')) # Passes
assert_character_vector_or_glue(c("a", 1, "b")) # Throws default error
assert_character_vector_or_glue(matrix(c('A', 'B', 'C', 'D')))  # Throws error since type = matrix
assert_character_vector_or_glue(c("a", 1, "b"), "Custom error message") # Throws custom error
})

assertions documentation built on April 3, 2025, 5:52 p.m.