This is documentation for Mathematica 6, which was
based on an earlier version of the Wolfram Language.
 Built-in Mathematica Symbol Tutorials »| See Also »| More About »

# StringSplit

 StringSplit["string"]splits "string" into a list of substrings separated by whitespace. StringSplit["string", patt]splits into substrings separated by delimiters matching the string expression patt. StringSplit["string", {p1, p2, ...}]splits at any of the pi. StringSplit["string", patt->val]inserts val at the position of each delimiter. StringSplit["string", {p1->v1, ...}]inserts vi at the position of each delimiter pi. StringSplit["string", patt, n]splits into at most n substrings. StringSplit[{s1, s2, ...}, p]gives the list of results for each of the si.
• StringSplit[s] does not return the whitespace characters that delimit the substrings it returns.
• Whitespace includes any number of spaces, tabs and newlines.
• The string expression patt can contain any of the objects specified in the notes for StringExpression.
• If s contains two adjacent delimiters, StringSplit considers there to be a zero-length substring "" between them.
• StringSplit[s, patt] by default gives the list of substrings of s that occur between delimiters defined by patt; it does not include the delimiters themselves.
• StringSplit[s, patt->val] includes val at the position of each delimiter.
• StringSplit[s, patt:>val] evaluates val only when the pattern is found.
• StringSplit["string", {p1->v1, ..., pa, ...}] includes v1 at the position of delimiters matching p1, but omits delimiters matching pa.
• By default, StringSplit[s, patt] drops zero-length substrings associated with delimiters that appear at the beginning or end of s.
• StringSplit[s, patt, All] returns all substrings, including zero-length ones at the beginning or end.
• Setting the option makes StringSplit treat lowercase and uppercase letters as equivalent.
 Scope   (7)
 Options   (1)
 Applications   (3)
New in 5.1