Mathematica 9 is now available
SEARCH MATHEMATICA 8 DOCUMENTATION
THIS IS DOCUMENTATION FOR AN OBSOLETE PRODUCT.
SEE THE DOCUMENTATION CENTER FOR THE LATEST INFORMATION.
Mathematica > Core Language > String Manipulation > String Operations >
Built-in Mathematica SymbolTutorials »|See Also »|More About »

StringReplaceList

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 "string" matching the string expressions si.
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 si.
  • The string expressions si 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.
  • In replacements of the form si:>spi, the spi are not evaluated until each time they are used.
EXAMPLESCLOSE ALL
Basic Examples   (2)
Make replacements for c in all possible ways:
Make replacements for c in all possible ways:
In[1]:=
Click for copyable input
Out[1]=
 
In[1]:=
Click for copyable input
Out[1]=
Scope   (9)
Use string patterns:
Use a regular expression:
Use pattern matching for dates:
Mixed regular expressions and string patterns:
Use RuleDelayed (:>) in order to evaluate the right-hand side of a rule:
Generate at most two possible results:
Replace occurrences of either string:
StringReplaceList works on special characters:
StringReplaceList automatically threads over lists of strings:
Options   (1)
Make replacements for c in all possible ways, including uppercase letters:
There are fewer results when taking case sensitivity into account:
Applications   (2)
Five steps in the evolution of the Fibonacci multiway system [more info]:
Two steps in the evolution of another multiway system:
All possible replacements of the form axy...za LongRightArrow aXY...Za:
Possible Issues   (1)
StringReplaceList yields a StringExpression if the rule does not have a string result:
New in 5.1
Ask a question about this page  |  Suggest an improvement  |  Leave a message for the team