stri_locate_all_regex: Locate Occurrences of a Regex Pattern

Description

These functions find the indices, at which a regex pattern matches a substring of the input string.

Usage

stri_locate_all_regex(str, pattern, opts_regex = NULL)
stri_locate_first_regex(str, pattern, opts_regex = NULL)
stri_locate_last_regex(str, pattern, opts_regex = NULL)

Arguments

str

character vector of strings to search in

pattern

character vector of regular expressions

opts_regex

a named list with ICU Regex settings as generated with stri_opts_regex; NULL for default settings

Value

For stri_locate_all_regex, a list of max(length(str), length(pattern)) integer matrices is returned . The first column gives the start positions of matches, and the second column gives the end positions. Moreover, you may gen two NAs in one row for no match or NA arguments.
For stri_locate_first_regex and stri_locate_last_regex, you get an integer matrix with max(length(str), length(pattern)) rows, and two columns, giving the start and end positions of the first or the last matches, respectively, and NAs iff not found.

Details

Vectorized over str and pattern.

Other indexing: stri_locate_all_charclass, stri_locate_first_charclass, stri_locate_first_charclass, stri_locate_last_charclass, stri_locate_last_charclass; stri_locate_all_coll, stri_locate_first_coll, stri_locate_first_coll, stri_locate_last_coll, stri_locate_last_coll; stri_locate_all_fixed, stri_locate_first_fixed, stri_locate_first_fixed, stri_locate_last_fixed, stri_locate_last_fixed; stri_locate_all; stri_locate_boundaries; stri_locate_first; stri_locate_last; stri_locate_words; stri_locate; stri_sub, stri_sub<-

Other search_locate: stri_locate_all_charclass, stri_locate_first_charclass, stri_locate_first_charclass, stri_locate_last_charclass, stri_locate_last_charclass; stri_locate_all_coll, stri_locate_first_coll, stri_locate_first_coll, stri_locate_last_coll, stri_locate_last_coll; stri_locate_all_fixed, stri_locate_first_fixed, stri_locate_first_fixed, stri_locate_last_fixed, stri_locate_last_fixed; stri_locate_all; stri_locate_boundaries; stri_locate_first; stri_locate_last; stri_locate_words; stri_locate; stringi-search

Other search_regex: stri_count_regex; stri_detect_regex; stri_extract_all_regex, stri_extract_first_regex, stri_extract_first_regex, stri_extract_last_regex, stri_extract_last_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_first_regex, stri_replace_first_regex, stri_replace_last_regex, stri_replace_last_regex; stri_split_regex; stringi-search-regex; stringi-search

Examples

Run this code

if (stri_install_check(silent=TRUE))
stri_locate_all_regex('XaaaaX',
   c('\\p{Ll}', '\\p{Ll}+', '\\p{Ll}{2,3}', '\\p{Ll}{2,3}?'))

if (stri_install_check(silent=TRUE))
stri_locate_first_regex('XaaaaX',
   c('\\p{Ll}', '\\p{Ll}+', '\\p{Ll}{2,3}', '\\p{Ll}{2,3}?'))

if (stri_install_check(silent=TRUE))
stri_locate_last_regex('XaaaaX',
   c('\\p{Ll}', '\\p{Ll}+', '\\p{Ll}{2,3}', '\\p{Ll}{2,3}?'))

Run the code above in your browser using DataCamp Workspace