match – zoo

Value Matching

Description

MATCH is a generic function for value matching.

Usage

MATCH(x, table, nomatch = NA, ...)
## S3 method for class 'times'
MATCH(x, table, nomatch = NA, units = "sec", eps = 1e-10, ...)

Arguments

x an object.

table the values to be matched against.

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

units See trunc.times.

eps See trunc.times.

… further arguments to be passed to methods.

Details

MATCH is a new generic function which aims at providing the functionality of the non-generic base function match for arbitrary objects. Currently, there is a default method which simply calls match and various methods for time/date objects.

The MATCH method for Date objects coerces the table to Date as well (if necessary) and then uses match(unclass(x), unclass(table), …. Similarly, the MATCH methods for POSIXct, POSIXlt, and timeDate coerce both x and table to POSIXct and then match the unclassed objects.

MATCH.times is used for chron objects. x will match any time in table less than units away.

Examples

library("zoo")

MATCH(1:5, 2:3)

[1] NA  1  2 NA NA