Lianja
Lianja
Regular Expression with Capture Groups
See more Regular Expressions Examples
Note: Chilkat uses PCRE2. See PCRE2 Regular Expressions
Also see: PCRE2 Performance
Demonstrates the following PCRE2 regular expression:
See the sample code below.
Name:\s+(\w+)\s+(\w+),\s+Email:\s+(\S+)
And apply it to this string:
Name: John Smith, Email: john.smith@example.com
Regex Components Explained
| Part | Meaning | Matched Text |
|---|---|---|
| "Name:" | Matches the literal text "Name:" | "Name:" |
| "\s+" | Matches one or more whitespace characters (spaces, tabs, etc.) | (space) |
| "(\w+)" | Capture Group 1: One or more word characters ("a-zA-Z0-9_") | "John" |
| "\s+" | More whitespace | (space) |
| "(\w+)" | Capture Group 2: Another word (the last name) | "Smith" |
| "," | A literal comma | "," |
| "\s+" | Whitespace again | (space) |
| "Email:" | Matches the literal "Email:" | "Email:" |
| "\s+" | Whitespace | (space) |
| "(\S+)" | Capture Group 3: One or more non-whitespace characters | "john.smith@example.com" |
Matches for Your Example String
String:
"Name: John Smith, Email: john.smith@example.com"
Regex Match Groups:
| Group | Captured Value |
|---|---|
| Group 1 | "John" |
| Group 2 | "Smith" |
| Group 3 | "john.smith@example.com" |
Notes on Character Classes
\wmatches[a-zA-Z0-9_]— so it doesn’t include punctuation like a period.\Smatches any non-whitespace character, so it’s good for capturing an email.
Chilkat Lianja Downloads
llSuccess = .F.
lcSubject = "Name: John Smith, Email: john.smith@example.com"
lcPattern = "Name:\\s+(\\w+)\\s+(\\w+),\\s+Email:\\s+(\\S+)"
loSb = createobject("CkStringBuilder")
loSb.Append(lcSubject)
loJson = createobject("CkJsonObject")
loJson.EmitCompact = .F.
lnTimeoutMs = 2000
lnNumMatches = loSb.RegexMatch(lcPattern,loJson,lnTimeoutMs)
if (lnNumMatches < 0) then
// Probably an error in the regular expression.
// Suggestion: Use AI to help create and/or diagnose regular expressions.
? loSb.LastErrorText
release loSb
release loJson
return
endif
// Examine the matches:
? loJson.Emit()
// This is the JSON with the match information.
// See the JSON parsing code below to get the matched capture group values.
// Important: Capture group 0 always contains the entire match — that is, the portion of the input string that matches the full regular expression.
// {
// "match": [
// {
// "group": [
// {
// "cap": "Name: John Smith, Email: john.smith@example.com",
// "idx": 0,
// "len": 47
// },
// {
// "cap": "John",
// "idx": 6,
// "len": 4
// },
// {
// "cap": "Smith",
// "idx": 11,
// "len": 5
// },
// {
// "cap": "john.smith@example.com",
// "idx": 25,
// "len": 22
// }
// ]
// }
// ]
// }
i = 0
lnMatchCount = loJson.SizeOfArray("match")
do while i < lnMatchCount
? "Match " + str(i + 1) + ":"
loJson.I = i
j = 0
lnNumCaptureGroups = loJson.SizeOfArray("match[i].group")
do while j < lnNumCaptureGroups
loJson.J = j
lcCap = loJson.StringOf("match[i].group[j].cap")
? str(j) + ": " + lcCap
j = j + 1
enddo
i = i + 1
enddo
// Capture group 0 always contains the entire match — that is, the portion of the input string that matches the full regular expression.
// Output
// Match 1:
// 0: Name: John Smith, Email: john.smith@example.com
// 1: John
// 2: Smith
// 3: john.smith@example.com
release loSb
release loJson