StringReplaceList["string", s->sp] or StringReplaceList["string", {s1->sp1, s2->sp2, ...}]
gives a list of the strings obtained by replacing each individual occurrence of substrings in matching the string expressions .

StringReplaceList["string", srules, n]
gives a list of the first n results obtained.

StringReplaceList[{s1, s2, ...}, srules]
gives the list of results for each of the .

Details and OptionsDetails and Options

  • The string expressions can contain any of the objects specified in the notes for StringExpression.
  • In each of the results returned by StringReplaceList only one substring has been replaced.
  • StringReplaceList goes through a string, testing substrings that start at each successive character position. On each substring, it tries in turn each of the transformation rules you have specified, returning a result for each one that applies.
  • StringReplaceList in effect carries out a single step in the evolution of a multiway system.
  • If the in the replacements do not evaluate to strings, StringReplaceList will yield a StringExpression rather than an ordinary string.
  • In replacements of the form , the are not evaluated until each time they are used.
  • Setting the option IgnoreCase->True makes StringReplaceList treat lowercase and uppercase letters as equivalent.
New in 5.1
New to Mathematica? Find your learning path »
Have a question? Ask support »