Assert object does not include any illegal values — assert_excludes • assertions

Assert x does not include illegal elements

Usage

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

Arguments

x: An object
illegal: The prohibited elements to check for
msg: A character string describing the error message if x includes any illegal elements
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 includes any illegal elements, otherwise aborts with the error message specified by msg

Examples

try({
assert_directory(system.file("package = assertions"))
assert_directory("foo") # Throws Error
})
#> Error in assert_directory(system.file("package = assertions")) : 
#>   could not find function "assert_directory"