assertions (version 0.3.0)

assert_all_strings_contain: Assert all strings contain a regex pattern

Description

Assert all elements of a character vector match a regex pattern.

Usage

assert_all_strings_contain(
  x,
  pattern,
  ignore.case = FALSE,
  perl = FALSE,
  fixed = FALSE,
  useBytes = FALSE,
  msg = NULL,
  call = rlang::caller_env(),
  arg_name = NULL
)

Value

invisible(TRUE) if x matches pattern, otherwise aborts with the error message specified by msg

Arguments

x

An object to check

pattern

A regular expression pattern (string)

ignore.case, perl, fixed, useBytes

Logical flags passed to grepl()

msg

A character string containing the error message to display if x does not match pattern

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).

Examples

try({
assert_all_strings_contain(c("abc", "a1"), "^a") # Passes
assert_all_strings_contain(c("abc", "b1"), "^a") # Throws default error
assert_all_strings_contain(c("abc", "b1"), "^a", msg = "Custom error message") # Throws custom error
})