THIS IS DOCUMENTATION FOR AN OBSOLETE PRODUCT.
SEE THE DOCUMENTATION CENTER FOR THE LATEST INFORMATION.

DOCUMENTATION CENTER SEARCH

New to Mathematica? Find your learning path »

Mathematica > Core Language > String Manipulation > String Operations > StringReplaceList >

BUILT-IN MATHEMATICA SYMBOL

Tutorials »|See Also »|More About »

StringReplaceList

or StringReplaceList

gives a list of the strings obtained by replacing each individual occurrence of substrings in

matching the string expressions

StringReplaceList

gives a list of the first n results obtained.

StringReplaceList

gives the list of results for each of the

MORE INFORMATION

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.

EXAMPLES

CLOSE ALL

Basic Examples (2)

Make replacements for

in all possible ways:

Make replacements for

in all possible ways:

In[1]:=

Out[1]=

In[1]:=

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

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

Two steps in the evolution of another multiway system:

All possible replacements of the form

Possible Issues (1)

StringReplaceList yields a StringExpression if the rule does not have a string result: