stringi (version 0.2-4)

stri_extract_first: Extract First Pattern Match

Description

A convenience function. Calls either stri_extract_first_regex, stri_extract_first_coll, or stri_extract_first_charclass, depending on the argument used.

Usage

stri_extract_first(str, ..., regex, coll, charclass)

Arguments

str

character vector of strings to search in

...

additional arguments passed to the underlying functions

regex

character vector; regular expressions

coll

character vector; canonically equivalent patterns

charclass

character vector; identifiers of character classes

Value

• Returns a character vector.

Details

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

See Also

Other search_extract: stri_extract_all_charclass, stri_extract_first_charclass, stri_extract_first_charclass, stri_extract_last_charclass, stri_extract_last_charclass; stri_extract_all_coll, stri_extract_first_coll, stri_extract_first_coll, stri_extract_last_coll, stri_extract_last_coll; stri_extract_all_regex, stri_extract_first_regex, stri_extract_first_regex, stri_extract_last_regex, stri_extract_last_regex; stri_extract_all; stri_extract_last; stri_extract_words; stri_extract; stringi-search

Examples

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