Syntax | Code Block |
---|
| set splittedStringArray = aString.split(regExpPattern)
set splittedStringArray = split(LITERAL, regExpPattern) |
|
---|
Semantics | Returns an array of strings. Wherever the pattern matches |
---|
, the string will be split. The string fragments are stored in the array splittedStringArray. The state of the current string is not changed. |
Info |
---|
icon | false |
---|
title | Note the following behavior of regular expressions:If pattern expression regExpPattern contains capturing parentheses, the captured data will also be saved in the destination array, together with the fields themselves (see also the examples below and the ICU User Guide > Regular Expressions > Using split()). |
Substitutables | aString | Can be any variable or object attribute having the type String. |
---|
regExpPattern | Regular expression (see Regular Expressions for a list of valid regular expressions). An introduction into regular expressions can be found at http://www.regular-expressions.info/. |
LITERAL | String literal. |
Examples | Code Block |
---|
| set splittedStringArray = stringSet.s1.split("\S+ |
|
---|
");Assume we have a string containing a list of customers:
Variable | Value |
---|
string | "Spring Corp., Summer Ltd.; Autumn & Co., Winter & Partners" |
Assuming that the split character is either the ",
" or the ";
, you can split this string with the following results:Regular Expression | Result splittedStringArray |
set splittedStringArray = string.split(",|;"["Spring Corp.", "Summer Ltd.", "Autumn & Co.", "Winter & Partners"] | set splittedStringArray = string.split("(,|;)"); | ["Spring Corp.", "Summer Ltd.", "Autumn & Co.", "Winter & Partners", ",", ";"]