stringi (version 1.2.2)

stri_flatten: Flatten a String

Description

Joins the elements of a character vector into one string.

Usage

stri_flatten(str, collapse = "", na_empty = FALSE, omit_empty = FALSE)

Arguments

str

a vector of strings to be coerced to character

collapse

a single string denoting the separator

na_empty

single logical value; should missing values in str be treated as empty strings?

omit_empty

single logical value; should missing values in str be omitted?

Value

Returns a single string, i.e., a character vector of length 1.

Details

The stri_flatten(str, collapse='XXX') call is equivalent to paste(str, collapse='XXX', sep="").

If you wish to use some more fancy (e.g. differing) separators between flattened strings, call stri_join(str, separators, collapse='').

If str is not empty, then a single string is returned. If collapse has length > 1, then only first string will be used.

See Also

Other join: stri_dup, stri_join_list, stri_join

Examples

# NOT RUN {
stri_flatten(LETTERS)
stri_flatten(LETTERS, collapse=",")
stri_flatten(c('abc', '123', '\u0105\u0104'))
stri_flatten(stri_dup(letters[1:6],1:3))
stri_flatten(c(NA, "", "A", "", "B", NA, "C"), collapse=",", na_empty=TRUE, omit_empty=TRUE)

# }