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",pattval]

inserts val at the position of each delimiter.

StringSplit["string",{p1v1,}]

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.

Details 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 zerolength 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 zerolength substrings associated with delimiters that appear at the beginning or end of s.
  • StringSplit[s,patt,All] returns all substrings, including zerolength 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.

Examples

open allclose all

Basic Examples  (2)

Pick out substrings delimited by whitespace:

In[1]:=
Click for copyable input
Out[1]=

Show the substrings with quotes:

In[2]:=
Click for copyable input
Out[2]//InputForm=

Split a string at every --:

In[1]:=
Click for copyable input
Out[1]=

Scope  (8)

Generalizations & Extensions  (1)

Options  (1)

Applications  (4)

Properties & Relations  (4)

Possible Issues  (1)

See Also

Split  StringTrim  StringCases  FileNameSplit  StringExtract  StringPartition

Tutorials

Introduced in 2004
(5.1)