is.empty: is.empty

is.emptyR Documentation

is.empty

Description

evaluates empty elements in a vector

Usage

is.empty(x, all.na = FALSE, na.empty = TRUE, trim = TRUE)

Arguments

x

A vector to evaluate elements

all.na

(FALSE / TRUE) Return a TRUE if all elements are NA

na.empty

(TRUE / FALSE) Return TRUE if element is NA

trim

(TRUE / FALSE) Trim empty strings

Details

This function evaluates if an element in a vector is empty the na.empty argument allows for evaluating NA values (TRUE if NA) and all.na returns a TRUE if all elements are NA. The trim argument trims a character string to account for the fact that c(" ") is not empty but, a vector with c("") is empty. Using trim = TRUE will force both to return TRUE

Value

A Boolean indicating empty elements in a vector, if all.na = FALSE a TRUE/FALSE value will be returned for each element in the vector

Author(s)

Jeffrey S. Evans <jeffrey_evans@tnc.org>

Examples

is.empty( c("") )
is.empty( c(" ") )
is.empty( c(" "), trim=FALSE )

is.empty( c("",NA,1) )
is.empty( c("",NA,1), na.empty=FALSE)

is.empty( c(NA,NA,NA) )
is.empty( c(NA,NA,NA), all.na=TRUE )
is.empty( c(NA,2,NA), all.na=TRUE )

any( is.empty( c("",2,3) ) )
any( is.empty( c(1,2,3) ) )


spatialEco documentation built on Nov. 18, 2023, 1:13 a.m.