|
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.
|
•
|
All of the StringTools package commands treat strings as (null-terminated) sequences of -bit (ASCII) characters. Thus, there is no support for multibyte character encodings, such as unicode encodings.
|
|
|
Examples
|
|
>
|
|
>
|
|
>
|
|
>
|
|
>
|
|
| (4) |
>
|
|
>
|
|
>
|
|
>
|
|
>
|
|
| (9) |
You can remove unwanted empty strings as follows.
>
|
|
|
|
|