StringTools[RegSplit] - split a string on a regular expression
|
Calling Sequence
|
|
RegSplit( pattern, text )
|
|
Parameters
|
|
pattern
|
-
|
string; regular expression
|
text
|
-
|
string; string to split
|
|
|
|
|
Description
|
|
•
|
The RegSplit(pattern, text) command splits a string text at substrings matching the regular expression pattern. The sequence of substrings of text that remain after substrings of text that match pattern have been elided is returned.
|
•
|
Splitting the empty string on any regular expression yields the expression sequence NULL.
|
•
|
If the regular expression pattern matches the empty string, an exception is raised.
|
•
|
Empty strings may result when adjacent matches to pattern occur within text. These can be removed as shown in the examples below.
|
•
|
Use StringTools[Split] to split a string at any of a set of characters. (See the examples, below.) Although this can be accomplished with RegSplit, StringTools[Split] is more efficient for this special case.
|
|
|
Examples
|
|
>
|
|
>
|
|
| (1) |
>
|
|
| (2) |
>
|
|
| (3) |
>
|
|
| (4) |
>
|
|
>
|
|
| (5) |
>
|
|
| (6) |
>
|
|
| (7) |
>
|
|
| (8) |
>
|
|
| (9) |
You can remove unwanted empty strings as follows.
>
|
|
| (10) |
|
|
Download Help Document
Was this information helpful?