mirror of
git://git.code.sf.net/p/zsh/code
synced 2025-01-19 11:31:26 +01:00
30 lines
1 KiB
Text
30 lines
1 KiB
Text
COMMENT(!MOD!zsh/regex
|
|
Interface to the POSIX regex library.
|
|
!MOD!)
|
|
cindex(regular expressions)
|
|
cindex(regex)
|
|
The tt(zsh/regex) module makes available the following test condition:
|
|
|
|
startitem()
|
|
findex(regex-match)
|
|
item(var(expr) tt(-regex-match) var(regex))(
|
|
Matches a string against a POSIX extended regular expression.
|
|
On successful match,
|
|
matched portion of the string will normally be placed in the tt(MATCH)
|
|
variable. If there are any capturing parentheses within the regex, then
|
|
the tt(match) array variable will contain those.
|
|
If the match is not successful, then the variables will not be altered.
|
|
|
|
For example,
|
|
|
|
example([[ alphabetical -regex-match ^a+LPAR()[^a]PLUS()+RPAR()a+LPAR()[^a]+PLUS()+RPAR()a ]] &&
|
|
print -l $MATCH X $match)
|
|
|
|
If the option tt(REMATCH_PCRE) is not set, then the tt(=~) operator will
|
|
automatically load this module as needed and will invoke the
|
|
tt(-regex-match) operator.
|
|
|
|
If tt(BASH_REMATCH) is set, then the array tt(BASH_REMATCH) will be set
|
|
instead of tt(MATCH) and tt(match).
|
|
)
|
|
enditem()
|