Breadcrumbs

split() Operation


Syntax

 


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.

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

 


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