StringReplaceList

✖
`StringReplaceList`

✖

StringReplaceList["string",ssp] or StringReplaceList["string",{s₁sp₁,s₂sp₂,…}]

gives a list of the strings obtained by replacing each individual occurrence of substrings in "string" matching the string expressions s_i.

✖

StringReplaceList["string",srules,n]

gives a list of the first n results obtained.

✖

StringReplaceList[{s₁,s₂,…},srules]

gives the list of results for each of the s_i.

Details and Options

The string expressions s_i 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 sp_i in the replacements s_i->sp_i do not evaluate to strings, StringReplaceList will yield a StringExpression rather than an ordinary string.
In replacements of the form s_i:>sp_i, the sp_i are not evaluated until each time they are used.
Setting the option IgnoreCase->True makes StringReplaceList treat lowercase and uppercase letters as equivalent.

Examples

open allclose all

Basic Examples (2)Summary of the most common use cases

Make replacements for "c" in all possible ways:

In[1]:=1

✖

https://wolfram.com/xid/0dqtkayo286-ouo

Out[1]=1

In[1]:=1

✖

https://wolfram.com/xid/0dqtkayo286-yyq

Out[1]=1

Scope (9)Survey of the scope of standard use cases

Use string patterns:

In[1]:=1

✖

https://wolfram.com/xid/0dqtkayo286-ird4se

Out[1]=1

Use a regular expression:

In[1]:=1

✖

https://wolfram.com/xid/0dqtkayo286-vq6uak

Out[1]=1

Use pattern matching for dates:

In[1]:=1

✖

https://wolfram.com/xid/0dqtkayo286-eg3o9g

Out[1]=1

Mixed regular expressions and string patterns:

In[1]:=1

✖

https://wolfram.com/xid/0dqtkayo286-w8gzod

Out[1]=1

Use RuleDelayed (:>) in order to evaluate the right-hand side of a rule:

In[1]:=1

✖

https://wolfram.com/xid/0dqtkayo286-clnwcm

Out[1]=1

Generate at most two possible results:

In[1]:=1

✖

https://wolfram.com/xid/0dqtkayo286-0cnztn

Out[1]=1

Replace occurrences of either string:

In[1]:=1

✖

https://wolfram.com/xid/0dqtkayo286-bhpvcm

Out[1]=1

StringReplaceList works on special characters:

In[1]:=1

✖

https://wolfram.com/xid/0dqtkayo286-3c7un

Out[1]=1

StringReplaceList automatically threads over lists of strings:

In[1]:=1

✖

https://wolfram.com/xid/0dqtkayo286-hz99ah

Out[1]=1

Options (1)Common values & functionality for each option

IgnoreCase (1)

Make replacements for "c" in all possible ways, including uppercase letters:

In[1]:=1

✖

https://wolfram.com/xid/0dqtkayo286-juy2h

Out[1]=1

There are fewer results when taking case sensitivity into account:

In[2]:=2

✖

https://wolfram.com/xid/0dqtkayo286-f5iyl3

Out[2]=2

Applications (2)Sample problems that can be solved with this function

Five steps in the evolution of the Fibonacci multiway system [more info]:

In[1]:=1

✖

https://wolfram.com/xid/0dqtkayo286-mdq

Out[1]=1

Two steps in the evolution of another multiway system:

In[2]:=2

✖

https://wolfram.com/xid/0dqtkayo286-uao

Out[2]=2

All possible replacements of the form :

In[1]:=1

✖

https://wolfram.com/xid/0dqtkayo286-kco

Out[1]= 1

Possible Issues (1)Common pitfalls and unexpected behavior

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

In[1]:=1

✖

https://wolfram.com/xid/0dqtkayo286-civj3z

Out[1]=1

In[2]:=2

✖

https://wolfram.com/xid/0dqtkayo286-rjg7w8

Top