splits 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 .

StringSplit["string", patt->val]
inserts val at the position of each delimiter.

StringSplit["string", {p1->v1, ...}]
inserts at the position of each delimiter .

StringSplit["string", patt, n]
splits into at most n substrings.

StringSplit[{s1, s2, ...}, p]
gives the list of results for each of the .

Details and OptionsDetails and Options

  • 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.
  • StringSplit[s] is equivalent to StringSplit[s, Whitespace].
  • 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 at the position of delimiters matching , but omits delimiters matching .
  • 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 IgnoreCase->True makes StringSplit treat lowercase and uppercase letters as equivalent.
  • StringSplit["string", RegularExpression["regex"]] splits at delimiters matching the specified regular expression.
New in 5.1
New to Mathematica? Find your learning path »
Have a question? Ask support »