findPatterns() Operation

Syntax	NONE `set resultArray = aString.findPatterns(regExpPattern) set resultArray = findPatterns(LITERAL, regExpPattern)`
Semantics	Returns all occurrences of the pattern found in aString as string array. Raises an error if the pattern is not found. The state of the current string is not changed.
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.
Error Codes	Find the related error codes on System Errors of string operations.
Error Codes	`FUSSM/21`	Cannot find any occurrences of pattern <pattern> in string <string>.
Examples	This example returns `resultArray` = {X1, X2}. NONE `set s1 = "The findPatterns() operation finds the X1 and X2 in this phrase." set resultArray = s1.findPatterns("X.");` This example throws an error as there is no X in the string at all. NONE `set s1 = "The findPatterns() operation won't find the pattern." set resultArray = s1.findPattern("X.");`

Related Pages: