Adobe ColdFusion 8

REMatch

Description

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

For more information on regular expressions, including escape sequences, anchors, and modifiers, see "Using Regular Expressions in Functions" in the ColdFusion Developer's Guide.

Returns

An array of strings that match the expression.

Category

String functions

Function syntax

REMatch(reg_expression, string)

See also

Find, FindNoCase, REFind, REReplace, REReplaceNoCase, REMatchNoCase

Parameters

Parameter

Description

reg_expression

Regular expression for which to search. Case sensitive.

For more information, see "Using Regular Expressions in Functions" in the ColdFusion Developer's Guide.

string

A string or a variable that contains one. String in which to search.

Usage

This function finds all occurrence of a regular expression in a string.

Example

<!--- Find all the URLs in a web page retrieved via cfhttp:. --->
<!--- The search is case sensitive. --->
result = REMatch("https?://([-\w\.]+)+(:\d+)?(/([\w/_\.]*(\?\S+)?)?)?", cfhttp.filecontent);