reFindNoCase

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

reFindNoCase(reg_expression, String [, start] [, returnsubexpressions]) → returns any

  1. CFDocs
  2. Functions
  3. String Functions
  4. reFindNoCase
  5. CF4+
  6. Lucee
  7. 0 Issue
  8. Edit
See Also:   Find   FindNoCase   REFind

Argument Reference

reg_expression string
Required

string string
Required

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

start numeric
Default: 1

returnsubexpressions boolean
Default: false

True: if the regular expression is found, the first array
element contains the length and position, respectively,
of the first match.
If the regular expression contains parentheses that
group subexpressions, each subsequent array element
contains the length and position, respectively, of
the first occurrence of each group.
If the regular expression is not found, the arrays each
contain one element with the value 0.
False: the function returns the position in the string
where the match begins. Default.
Values:
  • true
  • false

scope string
Default: one

CF 2016+ * one: returns the first value that matches the regex.
* all: returns all values that match the regex.
Values:
  • one
  • all

Examples
Sample code invoking the reFindNoCase function 

reFindNoCase("E", "test 123!")

Expected Result: 2

CF 2016+ example with all optional arguments

serializeJSON(reFindNoCase("E", "test 123!", 1, true, "ALL"))

Expected Result: [{ "len":[1], "match":["e"], "pos":[2]}]

Signup for cfbreak to stay updated on the latest news from the ColdFusion / CFML community. One email, every friday.

Fork me on GitHub