Keep strings matching a pattern.

Usage

re2_subset(string, pattern, anchor = 0, omit_na = TRUE, parallel = FALSE, grain_size = 1e+05, ...)

Arguments

string: a character vector
pattern: a character vector or pre-compiled regular expressions
anchor: see UNANCHORED
omit_na: omit na result
parallel: use multithread
grain_size: a minimum chunk size for tuning the behavior of parallel algorithms
...: further arguments passed to re2

Value

A character vector.

Description

This is a convenient wrapper around x[re2_detect(x, pattern)]. Vectorised over strings and patterns.

Examples

fruit <- c("apple", "banana", "pear", "pinapple")
re2_subset(fruit, "a")

[1] "apple"    "banana"   "pear"     "pinapple"

re2_subset(fruit, "^a")

[1] "apple"

re2_subset(fruit, "a$")

[1] "banana"

re2_subset(fruit, "b")

[1] "banana"

re2_subset(fruit, "[aeiou]")

[1] "apple"    "banana"   "pear"     "pinapple"


re2_subset(c("a", NA, "b"), ".")

[1] "a" "b"