posterior (version 1.6.0)

match: Value Matching

Description

Generic version of base::match(). For base vectors, returns a vector of the positions of (first) matches of its first argument in its second. For rvars, returns an rvar of the matches.

Usage

match(x, table, ...)
# S3 method for default
match(x, ...)
# S3 method for rvar
match(x, ...)
x %in% table

Value

When x is a base vector, a vector of the same length as x.

When x is an rvar, an rvar the same shape as x.

Arguments

x

(multiple options) the values to be matched. Can be:

• A base vector: see base::match()

• An rvar

table

(vector) the values to be matched against.

...

Arguments passed on to base::match

nomatch

the value to be returned in the case when no match is found. Note that it is coerced to integer.

incomparables

a vector of values that cannot be matched. Any value in x matching a value in this vector is assigned the nomatch value. For historical reasons, FALSE is equivalent to NULL.

Details

For more information on how match behaves with base vectors, see base::match().

When x is an rvar, the draws of x are matched against table using base::match(), and the result is returned as an rvar.

The implementation of %in% here is identical to base::%in%, except it uses the generic version of match() so that non-base vectors (such as rvars) are supported.

Examples

x <- rvar(c("a","b","b","c","d"))
x %in% c("b","d")

# for additional examples, see base::match()