about summary refs log tree commit diff
path: root/Doc/Zsh
diff options
context:
space:
mode:
Diffstat (limited to 'Doc/Zsh')
-rw-r--r--Doc/Zsh/mod_regex.yo27
1 files changed, 27 insertions, 0 deletions
diff --git a/Doc/Zsh/mod_regex.yo b/Doc/Zsh/mod_regex.yo
new file mode 100644
index 000000000..08e92ab9f
--- /dev/null
+++ b/Doc/Zsh/mod_regex.yo
@@ -0,0 +1,27 @@
+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.
+The 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.
+
+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()