capture() Operation

set aStringArray = aString.capture(aRegExPattern)

Returns a list of all captured groups that are identified by the regular expression.

aString

Can be any variable or object attribute having the type String.  

aRegExPattern

A variable or a literal containing a valid regular expression defining groups within aString.

aStringArray

An array of String containing the found groups.

Assume we have an URL that we want to break down to its elements:

set aMailAddress = "info@acme-corp.com";
set elements = aMailAddress.capture("(.*)@(.*)\.(.*)");

This will result in an array elements having the array elements ["info", "acme-corp", "com"].