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 Developing ColdFusion Applications.
Returns
An array of strings that match the expression.
Category
History
- ColdFusion (2018 release) Update 5: Added the flag useJavaAsRegexEngine to Application.cfc. Enable this flag to use Java Regex as the default regex engine. For more information, see Application variables. For information on using Regular Expression using the flag, see Using Regular Expressions.
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 Developing ColdFusion Applications. |
string |
A string or a variable that contains one. String in which to search. |
Usage
This function finds all occurrences of a regular expression in a string.
Example
<cfhttp url="https://www.adobe.com"
method="get" result="httpResp" timeout="120">
<cfhttpparam type="header" name="Content-Type" value="application/json" />
</cfhttp>
<cfscript>
// Find all the URLs in a web page retrieved via cfhttp
// The search is case sensitive
result = REMatch("https?://([-\w\.]+)+(:\d+)?(/([\w/_\.]*(\?\S+)?)?)?", httpResp.Filecontent);
writeDump(result)
</cfscript>