diff options
| author | Moritz Lenz <moritz@casella.verplant.org> | 2011-03-19 10:44:23 +0000 |
|---|---|---|
| committer | Chris 'BinGOs' Williams <chris@bingosnet.co.uk> | 2011-03-19 10:44:23 +0000 |
| commit | 41ef34de832ea2283fbc3b35c6da583d89497204 (patch) | |
| tree | 5930ebbb701750e210b1372cae4e5f654570eb20 /pod | |
| parent | 646253b5bb64d062851d102e7c6847ce5c5d3e18 (diff) | |
| download | perl-41ef34de832ea2283fbc3b35c6da583d89497204.tar.gz | |
[PATCH] [pod] improve documentation for (?(cond)yes|no)
perlre: Include a high-level description of what it does, and what a missing
pattern means
perlreref: Include missing look-around cases
Signed-off-by: Chris 'BinGOs' Williams <chris@bingosnet.co.uk>
Diffstat (limited to 'pod')
| -rw-r--r-- | pod/perlre.pod | 6 | ||||
| -rw-r--r-- | pod/perlreref.pod | 4 |
2 files changed, 9 insertions, 1 deletions
diff --git a/pod/perlre.pod b/pod/perlre.pod index bb92720ec1..387c820621 100644 --- a/pod/perlre.pod +++ b/pod/perlre.pod @@ -1199,7 +1199,11 @@ X<(?()> =item C<(?(condition)yes-pattern)> -Conditional expression. C<(condition)> should be either an integer in +Conditional expression. Matches C<yes-pattern> if C<condition> yields +a true value, matches C<no-pattern> otherwise. A missing pattern always +matches. + +C<(condition)> should be either an integer in parentheses (which is valid if the corresponding pair of parentheses matched), a look-ahead/look-behind/evaluate zero-width assertion, a name in angle brackets or single quotes (which is valid if a group diff --git a/pod/perlreref.pod b/pod/perlreref.pod index 54b619f83b..efae00c693 100644 --- a/pod/perlreref.pod +++ b/pod/perlreref.pod @@ -243,6 +243,10 @@ There is no quantifier C<{,n}>. That's interpreted as a literal string. (?P>name) Recurse into a named subpattern (python syntax) (?(cond)yes|no) (?(cond)yes) Conditional expression, where "cond" can be: + (?=pat) look-ahead + (?!pat) negative look-ahead + (?<=pat) look-behind + (?<!pat) negative look-behind (N) subpattern N has matched something (<name>) named subpattern has matched something ('name') named subpattern has matched something |