stringi (version 0.1-25)

stri_locate_first: Locate First Occurrence of a Pattern

Description

A convenience function. Calls either stri_locate_first_regex, stri_locate_first_fixed, or stri_locate_first_charclass, depending on the argument used.

Usage

stri_locate_first(str, ..., regex, fixed, charclass)

Arguments

str

character vector of strings to search in

...

additional arguments passed to the underlying functions

regex

character vector; regular expressions

fixed

character vector; fixed patterns

charclass

character vector; identifiers of character classes

Value

• Returns an integer matrix with two columns, with double NAs in a row if a pattern not found.

Details

Unless you are very lazy, please call the underlying functions directly for better performance.

Please note that the parameters are considered in the following order: regex, fixed and class. Thus, if you specify regex and class, only the first one will be used.

See Also

Other indexing: stri_locate_all_charclass, stri_locate_all_charclass, stri_locate_first_charclass, stri_locate_first_charclass, stri_locate_last_charclass, stri_locate_last_charclass; stri_locate_all_fixed, stri_locate_all_fixed,, stri_locate_first_fixed, stri_locate_first_fixed,, stri_locate_last_fixed, stri_locate_last_fixed; 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_locate_all; stri_locate_last; stri_locate; stri_sub, stri_sub<-

Other search_locate: 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_locate_all_charclass, stri_locate_all_charclass, stri_locate_first_charclass, stri_locate_first_charclass, stri_locate_last_charclass, stri_locate_last_charclass; stri_locate_all_fixed, stri_locate_all_fixed,, stri_locate_first_fixed, stri_locate_first_fixed,, stri_locate_last_fixed, stri_locate_last_fixed; 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_locate_all; stri_locate_last; stri_locate; stringi-search

Examples

s <- 'Lorem ipsum dolor sit amet, consectetur adipisicing elit.'
stri_locate_first('XaaaaX',
   regex=c('\\p{Ll}', '\\p{Ll}+', '\\p{Ll}{2,3}', '\\p{Ll}{2,3}?'))
stri_locate_first('Bartolini', fixed=letters[1:3])
stri_locate_first('a b c', charclass='Zs')