R: Does text match a regex?

ore.ismatch {ore} | R Documentation

## Does text match a regex?

### Description

These functions test whether the elements of a character vector match a Oniguruma regular expression. The actual match can be retrieved using `ore.lastmatch`.

### Usage

    ore.ismatch(regex, text, ...)

    X %~% Y

    X %~~% Y

    X %~|% Y

### Arguments

`regex` | A single character string or object of class `"ore"`.
`text` | A character vector of strings to search.
`...` | Further arguments to `ore.search`.
`X` | A character vector or `"ore"` object. See Details.
`Y` | A character vector. See Details.

### Details

The `%~%` infix shorthand corresponds to `ore.ismatch(..., all=FALSE)`, while `%~~%` corresponds to `ore.ismatch(..., all=TRUE)`. Either way, the first argument can be an `"ore"` object, in which case the second is the text to search, or a character vector, in which case the second argument is assumed to contain the regex. The `%~|%` shorthand returns just those elements of the text vector which match the regular expression.

### Value

A logical vector, indicating whether elements of `text` match `regex`, or not.

### See Also

`ore.search`

### Examples

    # Test for the presence of a vowel
    ore.ismatch("[aeiou]", c("sky","lake"))  # => c(FALSE,TRUE)

    # The same thing, in shorter form
    c("sky","lake") %~% "[aeiou]"

    # Same again: the first argument must be an "ore" object this way around
    ore("[aeiou]") %~% c("sky","lake")

[Package ore version 1.6.0 Index]