prob (version 1.0-1)

isin: Test Whether One Vector Is In Another Vector

Description

See the title.

Usage

isin(x, …)
# S3 method for default
isin(x, y, ordered = FALSE, …)
# S3 method for data.frame
isin(x, …)

Arguments

x, y

vectors.

ordered

logical.

…

further arguments to be passed to or from other methods.

Value

Logical, or a vector of logicals.

Details

The function will only return TRUE if every element of y is present in the vector x, counting multiplicity. See the examples below. Of ordered = TRUE, then elements must be in the vector x in the order specified in y. Compare this to the behavior of the %in% function in the base package.

This is a generic function with a moethod for data frames, which applies isin() to each row of the data frame, with a vector as a result.

See Also

isrep

Examples

# NOT RUN {
x <- 1:10
y <- 3:7
z <- c(3,3,7)
isin(x,y)
isin(x,z)
isin(x, c(3,4,5), ordered = TRUE)
isin(x, c(3,5,4), ordered = TRUE)

S <- rolldie(4)
subset(S, isin(S, c(2,2,6), ordered = TRUE))

# }