This is documentation for Mathematica 6, which was
based on an earlier version of the Wolfram Language.
View current documentation (Version 11.1)


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.
New in 5.1