analyzeString

analyzeString(string, pattern) → object · String

Analyze a string against a regex pattern, returning match status and captured groups.

• string (required): the string to analyze

• pattern (required): regex pattern with capture groups

Returns: {match: boolean, groups: [string...], start: number, end: number}

echo '{"email": "user@example.com"}' \
  | utlx -e 'analyzeString($input.email, "(.+)@(.+)\\.(.+)")'
# {"match": true, "groups": ["user", "example", "com"], "start": 0, "end": 16}

// Input: {"date": "2026-05-01"}
let result = analyzeString($input.date, "^(\\d{4})-(\\d{2})-(\\d{2})$")
// result = {match: true, groups: ["2026", "05", "01"], start: 0, end: 10}
{
  valid: result.match,              // true
  year: if (result.match) result.groups[0] else null,   // "2026"
  month: if (result.match) result.groups[1] else null   // "05"
}
// Output: {"valid": true, "year": "2026", "month": "05"}