Documentation update.

This commit is contained in:
ph10 2019-12-29 11:44:51 +00:00
parent e8386662ba
commit bb1e50aa3c
3 changed files with 33 additions and 16 deletions

View File

@ -1650,7 +1650,7 @@ that succeeds is used. If the alternatives are within a group
<a href="#group">(defined below),</a>
"succeeds" means matching the rest of the main pattern as well as the
alternative in the group.
</P>
<a name="internaloptions"></a></P>
<br><a name="SEC13" href="#TOC1">INTERNAL OPTION SETTING</a><br>
<P>
The settings of the PCRE2_CASELESS, PCRE2_MULTILINE, PCRE2_DOTALL,
@ -1901,11 +1901,17 @@ are permitted for groups with the same number, for example:
(?|(?&#60;AA&#62;aa)|(?&#60;AA&#62;bb))
</pre>
The duplicate name constraint can be disabled by setting the PCRE2_DUPNAMES
option at compile time, or by the use of (?J) within the pattern. Duplicate
names can be useful for patterns where only one instance of the named capture
group can match. Suppose you want to match the name of a weekday, either as a
3-letter abbreviation or as the full name, and in both cases you want to
extract the abbreviation. This pattern (ignoring the line breaks) does the job:
option at compile time, or by the use of (?J) within the pattern, as described
in the section entitiled
<a href="#internaloptions">"Internal Option Setting"</a>
above.
</P>
<P>
Duplicate names can be useful for patterns where only one instance of the named
capture group can match. Suppose you want to match the name of a weekday,
either as a 3-letter abbreviation or as the full name, and in both cases you
want to extract the abbreviation. This pattern (ignoring the line breaks) does
the job:
<pre>
(?J)
(?&#60;DN&#62;Mon|Fri|Sun)(?:day)?|
@ -3834,7 +3840,7 @@ Cambridge, England.
</P>
<br><a name="SEC32" href="#TOC1">REVISION</a><br>
<P>
Last updated: 28 December 2019
Last updated: 29 December 2019
<br>
Copyright &copy; 1997-2019 University of Cambridge.
<br>

View File

@ -7671,7 +7671,9 @@ NAMED CAPTURE GROUPS
(?|(?<AA>aa)|(?<AA>bb))
The duplicate name constraint can be disabled by setting the PCRE2_DUP-
NAMES option at compile time, or by the use of (?J) within the pattern.
NAMES option at compile time, or by the use of (?J) within the pattern,
as described in the section entitiled "Internal Option Setting" above.
Duplicate names can be useful for patterns where only one instance of
the named capture group can match. Suppose you want to match the name
of a weekday, either as a 3-letter abbreviation or as the full name,
@ -9488,7 +9490,7 @@ AUTHOR
REVISION
Last updated: 28 December 2019
Last updated: 29 December 2019
Copyright (c) 1997-2019 University of Cambridge.
------------------------------------------------------------------------------

View File

@ -1,4 +1,4 @@
.TH PCRE2PATTERN 3 "28 December 2019" "PCRE2 10.35"
.TH PCRE2PATTERN 3 "29 December 2019" "PCRE2 10.35"
.SH NAME
PCRE2 - Perl-compatible regular expressions (revised API)
.SH "PCRE2 REGULAR EXPRESSION DETAILS"
@ -1643,6 +1643,7 @@ that succeeds is used. If the alternatives are within a group
alternative in the group.
.
.
.\" HTML <a name="internaloptions"></a>
.SH "INTERNAL OPTION SETTING"
.rs
.sp
@ -1901,11 +1902,19 @@ are permitted for groups with the same number, for example:
(?|(?<AA>aa)|(?<AA>bb))
.sp
The duplicate name constraint can be disabled by setting the PCRE2_DUPNAMES
option at compile time, or by the use of (?J) within the pattern. Duplicate
names can be useful for patterns where only one instance of the named capture
group can match. Suppose you want to match the name of a weekday, either as a
3-letter abbreviation or as the full name, and in both cases you want to
extract the abbreviation. This pattern (ignoring the line breaks) does the job:
option at compile time, or by the use of (?J) within the pattern, as described
in the section entitiled
.\" HTML <a href="#internaloptions">
.\" </a>
"Internal Option Setting"
.\"
above.
.P
Duplicate names can be useful for patterns where only one instance of the named
capture group can match. Suppose you want to match the name of a weekday,
either as a 3-letter abbreviation or as the full name, and in both cases you
want to extract the abbreviation. This pattern (ignoring the line breaks) does
the job:
.sp
(?J)
(?<DN>Mon|Fri|Sun)(?:day)?|
@ -3875,6 +3884,6 @@ Cambridge, England.
.rs
.sp
.nf
Last updated: 28 December 2019
Last updated: 29 December 2019
Copyright (c) 1997-2019 University of Cambridge.
.fi