zsh: The zsh/regex Module

Next: The zsh/sched Module, Previous: The zsh/param/private Module, Up: Zsh Modules [Contents][Index]

### 22.22 The zsh/regex Module

The `zsh/regex` module makes available the following test condition:

expr `-regex-match` regex

  Matches a string against a POSIX extended regular expression. On successful match, matched portion of the string will normally be placed in the `MATCH` variable. If there are any capturing parentheses within the regex, then the `match` array variable will contain those. If the match is not successful, then the variables will not be altered.

  For example,

      [[ alphabetical -regex-match ^a([^a]+)a([^a]+)a ]] &&
      print -l $MATCH X $match

  If the option `REMATCH_PCRE` is not set, then the `=~` operator will automatically load this module as needed and will invoke the `-regex-match` operator.

  If `BASH_REMATCH` is set, then the array `BASH_REMATCH` will be set instead of `MATCH` and `match`.