REMatch()

Uses a regular expression (RE) to search a string for a pattern, starting from a specified position.


	REMatch( regex=string, string=string, multiline=boolean );

Returns: Array

Argument	Description	Default
regex _{string, required}	edit Regular expression for which to search. Case sensitive. _{Alias: reg_expression}
string _{string, required}	edit String in which to search.
multiline _{boolean, optional}	edit If true indicate the regular expression should treat input as having multiple lines. This option affects the interpretation of the ^ and $ metacharacters. When true the ^ metacharacter matches at the beginning of every line, and the $ metacharacter matches at the end of every line. Additionally the . metacharacter will not match newlines when true. Introduced: 5.3.8.23	false

Argument

Description

Default

regex

_{string,

required}

edit

Regular expression for which to search. Case sensitive.

_{Alias:
reg_expression}

string

_{string,

required}

edit

String in which to search.

multiline

_{boolean,

optional}

edit

If true indicate the regular expression should treat input as having multiple lines. This option affects the interpretation of the ^ and $ metacharacters. When true the ^ metacharacter matches at the beginning of every line, and the $ metacharacter matches at the end of every line. Additionally the . metacharacter will not match newlines when true.

Introduced: 5.3.8.23

false

Usage Notes

edit

The regex engine depends on the application settings (this.regex.type). Up to Lucee 8 the default is perl (Apache ORO), which is deprecated: Lucee 9 uses java as the default, see Regex Migration to Lucee 9.

Examples

edit


writeDump(REMatch('[a-z]+','AbcacAcdd'));

REMatch()

Usage Notes

Examples

See also