Split a String Into Text Lines
These functions split each character string in a given vector into text lines.
stri_split_lines(str, omit_empty = FALSE) stri_split_lines1(str)
str |
character vector ( |
omit_empty |
logical vector; determines whether empty
strings should be removed from the result
[ |
Vectorized over str
and omit_empty
.
omit_empty
is applied when splitting. If set to TRUE
,
then empty strings will never appear in the resulting vector.
Newlines are represented with the Carriage Return (CR, 0x0D), Line Feed (LF, 0x0A), CRLF, or Next Line (NEL, 0x85) characters, depending on the platform. Moreover, the Unicode Standard defines two unambiguous separator characters, the Paragraph Separator (PS, 0x2029) and the Line Separator (LS, 0x2028). Sometimes also the Vertical Tab (VT, 0x0B) and the Form Feed (FF, 0x0C) are used for this purpose.
These stringi functions follow UTR#18 rules,
where a newline sequence
corresponds to the following regular expression:
(?:\u{D A}|(?!\u{D A})[\u{A}-\u{D}\u{85}\u{2028}\u{2029}]
.
Each match serves as a text line separator.
stri_split_lines
returns a list of character vectors.
If any input string is NA
, then the corresponding list element
is a single NA
string.
stri_split_lines1(str)
is equivalent to
stri_split_lines(str[1])[[1]]
(with default parameters),
therefore it returns a character vector. Moreover, if the input string
ends with a newline sequence, the last empty string is omitted from the
file's contents into text lines.
Unicode Newline Guidelines – Unicode Technical Report #13, https://www.unicode.org/standard/reports/tr13/tr13-5.html
Unicode Regular Expressions – Unicode Technical Standard #18, https://www.unicode.org/reports/tr18/
Other search_split:
about_search
,
stri_split_boundaries()
,
stri_split()
Other text_boundaries:
about_search_boundaries
,
about_search
,
stri_count_boundaries()
,
stri_extract_all_boundaries()
,
stri_locate_all_boundaries()
,
stri_opts_brkiter()
,
stri_split_boundaries()
,
stri_trans_tolower()
,
stri_wrap()
Please choose more modern alternatives, such as Google Chrome or Mozilla Firefox.