stri_extract_regex: Extract Regex Pattern Matches

Description Usage Arguments Details Value See Also Examples

Description

These functions extract substrings of str that match a given pattern.

See also stri_match_all_regex for extracting matches together with regex capture groups.

Usage

1
2
3
4
5

Arguments

str

character vector of strings to search in

pattern

character vector of regular expressions

opts_regex

a named list as generated with stri_opts_regex

Details

Vectorized over str and pattern.

Value

For stri_extract_all_regex, list of max(length(str), length(pattern)) character vectors is returned. Otherwise, you get a character vector. NA if not found.

See Also

Other search_extract: stri_extract_all_charclass, stri_extract_all_charclass, stri_extract_first_charclass, stri_extract_first_charclass, stri_extract_last_charclass, stri_extract_last_charclass; stri_extract_all_fixed, stri_extract_all_fixed,, stri_extract_first_fixed, stri_extract_first_fixed,, stri_extract_last_fixed, stri_extract_last_fixed; stri_extract_all; stri_extract_first; stri_extract_last; stri_extract; stringi-search

Other search_regex: stri_count_regex; stri_detect_regex; stri_locate_all_regex, stri_locate_all_regex, stri_locate_first_regex, stri_locate_first_regex, stri_locate_last_regex, stri_locate_last_regex; stri_match_all_regex, stri_match_all_regex, stri_match_first_regex, stri_match_first_regex, stri_match_last_regex, stri_match_last_regex; stri_opts_regex; stri_replace_all_regex, stri_replace_all_regex, stri_replace_first_regex, stri_replace_first_regex, stri_replace_last_regex, stri_replace_last_regex; stri_split_regex, stri_split_regex; stringi-search-regex; stringi-search

Examples

1
2
3
4
5
6
## Not run: 
stri_extract_all_regex('XaaaaX', c('\\p{Ll}', '\\p{Ll}+', '\\p{Ll}{2,3}', '\\p{Ll}{2,3}?'))
stri_extract_first_regex('XaaaaX', c('\\p{Ll}', '\\p{Ll}+', '\\p{Ll}{2,3}', '\\p{Ll}{2,3}?'))
stri_extract_last_regex('XaaaaX', c('\\p{Ll}', '\\p{Ll}+', '\\p{Ll}{2,3}', '\\p{Ll}{2,3}?'))

## End(Not run)

Example output

[[1]]
[1] "a" "a" "a" "a"

[[2]]
[1] "aaaa"

[[3]]
[1] "aaa"

[[4]]
[1] "aa" "aa"

[1] "a"    "aaaa" "aaa"  "aa"  
[1] "a"    "aaaa" "aaa"  "aa"  

stringi documentation built on May 2, 2019, 4:54 p.m.