split() Operation

Syntax

NONE

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 array splittedStringArray. The state of the current string is not changed.

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

NONE

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"]`