stri_extract_all_boundaries {stringi} | R Documentation |
These functions extract text between specific text boundaries.
stri_extract_all_boundaries(str, simplify = FALSE, omit_no_match = FALSE, ..., opts_brkiter = NULL) stri_extract_last_boundaries(str, ..., opts_brkiter = NULL) stri_extract_first_boundaries(str, ..., opts_brkiter = NULL) stri_extract_all_words(str, simplify = FALSE, omit_no_match = FALSE, locale = NULL) stri_extract_first_words(str, locale = NULL) stri_extract_last_words(str, locale = NULL)
str |
character vector or an object coercible to |
simplify |
single logical value;
if |
omit_no_match |
single logical value; if |
... |
additional settings for |
opts_brkiter |
a named list with ICU BreakIterator's settings
as generated with |
locale |
|
Vectorized over str
.
For more information on the text boundary analysis
performed by ICU's BreakIterator
, see
stringi-search-boundaries.
In case of stri_extract_*_words
,
Just like in stri_count_words
,
ICU's word BreakIterator
iterator is used
to locate word boundaries, and all non-word characters
(UBRK_WORD_NONE
rule status) are ignored.
For stri_extract_all_*
,
if simplify=FALSE
(the default), then a
list of character vectors is returned. Each string consists of
a separate word. In case of omit_no_match=FALSE
and
if there are no words or if a string is missing,
a single NA
is provided on output.
Otherwise, stri_list2matrix
with byrow=TRUE
argument
is called on the resulting object.
In such a case, a character matrix with length(str)
rows
is returned. Note that stri_list2matrix
's fill
argument
is set to an empty string and NA
,
for simplify
equal to TRUE
and NA
, respectively.
For stri_extract_first_*
and stri_extract_last_*
,
a character vector is returned.
A NA
element indicates no match.
Other search_extract: stri_extract_all
,
stri_match_all
,
stringi-search
Other locale_sensitive: %s<%
,
stri_compare
,
stri_count_boundaries
,
stri_duplicated
,
stri_enc_detect2
,
stri_locate_all_boundaries
,
stri_opts_collator
,
stri_order
,
stri_split_boundaries
,
stri_trans_tolower
,
stri_unique
, stri_wrap
,
stringi-locale
,
stringi-search-boundaries
,
stringi-search-coll
Other text_boundaries: stri_count_boundaries
,
stri_locate_all_boundaries
,
stri_opts_brkiter
,
stri_split_boundaries
,
stri_split_lines
,
stri_trans_tolower
,
stri_wrap
,
stringi-search-boundaries
,
stringi-search
stri_extract_all_words("stringi: THE string processing package 123.48...")