sjmisc: is_empty – R documentation

Become an expert in R — Interactive courses, Cheat Sheets, certificates and more!

is_empty

Check whether string, list or vector is empty

Description

This function checks whether a string or character vector (of length 1), a list or any vector (numeric, atomic) is empty or not.

Usage

is_empty(x, first.only = TRUE, all.na.empty = TRUE)

Arguments

`x`	String, character vector, list, data.frame or numeric vector or factor.
`first.only`	Logical, if `FALSE` and `x` is a character vector, each element of `x` will be checked if empty. If `TRUE`, only the first element of `x` will be checked.
`all.na.empty`	Logical, if `x` is a vector with `NA`-values only, `is_empty` will return `FALSE` if `all.na.empty = FALSE`, and will return `TRUE` if `all.na.empty = TRUE` (default).

Value

Logical, TRUE if x is a character vector or string and is empty, TRUE if x is a vector or list and of length 0, FALSE otherwise.

Note

NULL- or NA-values are also considered as "empty" (see 'Examples') and will return TRUE, unless all.na.empty==FALSE.

Examples

is_empty("test")
is_empty("")
is_empty(NA)
is_empty(NULL)

# string is not empty
is_empty(" ")

# however, this trimmed string is
is_empty(trim(" "))

# numeric vector
x <- 1
is_empty(x)
x <- x[-1]
is_empty(x)

# check multiple elements of character vectors
is_empty(c("", "a"))
is_empty(c("", "a"), first.only = FALSE)

# empty data frame
d <- data.frame()
is_empty(d)

# empty list
is_empty(list(NULL))

# NA vector
x <- rep(NA,5)
is_empty(x)
is_empty(x, all.na.empty = FALSE)

sjmisc

Data and Variable Transformation Functions

v2.8.6

GPL-3

Authors

Daniel Lüdecke [aut, cre] (<https://orcid.org/0000-0002-8895-3206>), Iago Giné-Vázquez [ctb], Alexander Bartel [ctb] (<https://orcid.org/0000-0002-1280-6138>)

Initial release