functools (version 0.2.0)

Any: Test if any items in an object evaluate to TRUE.

Description

Any() is a predicate functional that takes a predicate function .f and an iterable object .x and:

1. iterates over each item i in object .x,
2. evaluates .f(i),
3. and ultimately returns TRUE if any items i in object .x evaluate as TRUE.

Usage

Any(.x, .f, ..., na.rm = FALSE)

Arguments

.x

An iterable object.

.f

A predicate function.

...

Further arguments passed to the predicate function.

na.rm

A logical value indicating whether NA values should be stripped before the computation proceeds.

Value

A logical value indicating if any items evaluated as TRUE.

See Also

All to test if all items in an object evaluate to TRUE.

Other predicate functionals: All; Reject

Examples

# Examples
data(mtcars)
Any(mtcars, is.numeric) # TRUE
Any(mtcars, is.character) # FALSE
mtcars$am <- factor(mtcars$am)
Any(mtcars, is.numeric) # TRUE
Any(mtcars, is.factor) # TRUE

# Handles NAs and NULLs
Any(list(NA, "3", NULL), is.numeric) # FALSE
Any(list(NA, 3, NULL), is.numeric) # TRUE
Any(list(NA, "3", NULL, 5), is.numeric) #TRUE

# Use na.rm = TRUE to remove NULLS
Any(list(NA, FALSE), Identity) # NA
Any(list(NA, FALSE), Identity, na.rm = TRUE) # FALSE