stringr (version 0.6.2)

str_split: Split up a string into a variable number of pieces.

Description

Vectorised over string. pattern should be a single pattern, i.e. a character vector of length one.

Usage

str_split(string, pattern, n = Inf)

Arguments

string

input character vector

pattern

pattern to split up by, as defined by a POSIX regular expression. See the ``Extended Regular Expressions'' section of regex for details. If NA, returns original string. If ""

n

maximum number of pieces to return. Default (Inf) uses all possible split positions.

Value

• a list of character vectors.

See Also

str_split_fixed for fixed number of splits

Examples

fruits <- c(
  "apples and oranges and pears and bananas",
  "pineapples and mangos and guavas"
)
str_split(fruits, "and ")

# Specify n to restrict the number of possible matches
str_split(fruits, "and ", n = 3)
str_split(fruits, "and ", n = 2)
# If n greater than number of pieces, no padding occurs
str_split(fruits, "and ", n = 5)