From e4cdad9700342b4dbc1837307580134eee274f33 Mon Sep 17 00:00:00 2001 From: Peter Stephenson Date: Wed, 2 May 2007 11:13:14 +0000 Subject: unposted: regex fix-ups: missing doc file plus pointer fixes --- Doc/Zsh/mod_regex.yo | 27 +++++++++++++++++++++++++++ 1 file changed, 27 insertions(+) create mode 100644 Doc/Zsh/mod_regex.yo (limited to 'Doc') 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() -- cgit 1.4.1