Check Length — chk_length • chk

Checks length is a particular value or range using

length(x) >= length && length(x) <= upper

Usage

chk_length(x, length = 1L, upper = length, x_name = NULL)

vld_length(x, length = 1L, upper = length)

Arguments

x: The object to check.
length: A count of the length.
upper: A count of the max length.
x_name: A string of the name of object x or NULL.

Value

The chk_ function throws an informative error if the test fails or returns the original object if successful so it can used in pipes.

The vld_ function returns a flag indicating whether the test was met.

Functions

vld_length(): Validate Length

See also

Other chk_misc: chk_match(), chk_missing(), chk_named(), chk_not_any_na(), chk_not_empty(), chk_not_missing(), chk_sorted(), chk_unique(), chk_valid_name()

Examples

# chk_length
chk_length("text")
try(vld_length("text", length = 2))
#> [1] FALSE
# vld_length
vld_length(2:1, 2)
#> [1] TRUE
vld_length(2:1, 1)
#> [1] FALSE