REGEX_EXTRACT_ALL

All functions > STRING > REGEX_EXTRACT_ALL

Returns an array of all substrings matching a regular expression pattern.

Signatures

Returns: Array of all matching substrings

REGEX_EXTRACT_ALL(string: VARCHAR, pattern: VARCHAR, [group_number: BIGINT]) → ARRAYVARCHAR
sql
ParameterTypeRequiredDescription
stringVARCHARYesString to search in
patternVARCHARYesRegular expression pattern
group_numberBIGINTNoCapture group to return (0 = full match, 1 = first group, etc.). Defaults to 0

Notes

  • Returns all non-overlapping matches in order
  • Group 0 (default) returns the entire match for each occurrence
  • Group 1+ returns the corresponding capture group for each occurrence
  • Returns an empty array if no matches are found

Examples

FeatureQL
SELECT
    f1 := REGEX_EXTRACT_ALL('abc123def456', '[0-9]+'),  -- Extract all digit groups
    f2 := REGEX_EXTRACT_ALL('cat bat hat', '[a-z]at'),  -- Extract all matches
    f3 := REGEX_EXTRACT_ALL('a1b2c3', '([a-z])([0-9])', 1),  -- Extract first capture group
    f4 := REGEX_EXTRACT_ALL('no match', '[0-9]+')  -- No matches returns empty array
;
Result
f1 ARRAYf2 ARRAYf3 ARRAYf4 ARRAY
[123, 456][cat, bat, hat][a, b, c][]

Last update at: 2026/03/03 16:47:38
Last updated: 2026-03-03 16:48:19