/[pcre]/code/trunk/doc/pcreapi.3
ViewVC logotype

Diff of /code/trunk/doc/pcreapi.3

Parent Directory Parent Directory | Revision Log Revision Log | View Patch Patch

revision 1112 by chpe, Tue Oct 16 15:56:38 2012 UTC revision 1113 by chpe, Tue Oct 16 15:57:12 2012 UTC
# Line 1238  returned. For anchored patterns, -2 is r Line 1238  returned. For anchored patterns, -2 is r
1238  .P  .P
1239  Since for the 32-bit library using the non-UTF-32 mode, this function is unable  Since for the 32-bit library using the non-UTF-32 mode, this function is unable
1240  to return the full 32-bit range of the character, this value is deprecated;  to return the full 32-bit range of the character, this value is deprecated;
1241  instead the PCRE_INFO_FIRSTLITERALSET and PCRE_INFO_FIRSTLITERAL values should  instead the PCRE_INFO_FIRSTCHARACTERFLAGS and PCRE_INFO_FIRSTCHARACTER values should
1242  be used.  be used.
1243  .sp  .sp
1244    PCRE_INFO_FIRSTTABLE    PCRE_INFO_FIRSTTABLE
# Line 1290  is -1. Line 1290  is -1.
1290  .P  .P
1291  Since for the 32-bit library using the non-UTF-32 mode, this function is unable  Since for the 32-bit library using the non-UTF-32 mode, this function is unable
1292  to return the full 32-bit range of the character, this value is deprecated;  to return the full 32-bit range of the character, this value is deprecated;
1293  instead the PCRE_INFO_LASTLITERAL2SET and PCRE_INFO_LASTLITERAL2 values should  instead the PCRE_INFO_REQUIREDCHARFLAGS and PCRE_INFO_REQUIREDCHAR values should
1294  be used.  be used.
1295  .sp  .sp
1296    PCRE_INFO_MAXLOOKBEHIND    PCRE_INFO_MAXLOOKBEHIND
# Line 1436  is made available via this option so tha Line 1436  is made available via this option so tha
1436  .\"  .\"
1437  documentation for details).  documentation for details).
1438  .sp  .sp
1439    PCRE_INFO_FIRSTLITERALSET    PCRE_INFO_FIRSTCHARACTERFLAGS
1440  .sp  .sp
1441  Return information about the first data unit of any matched string, for a  Return information about the first data unit of any matched string, for a
1442  non-anchored pattern. The fourth argument should point to an \fBint\fP  non-anchored pattern. The fourth argument should point to an \fBint\fP
# Line 1444  variable. Line 1444  variable.
1444  .P  .P
1445  If there is a fixed first value, for example, the letter "c" from a pattern  If there is a fixed first value, for example, the letter "c" from a pattern
1446  such as (cat|cow|coyote), 1 is returned, and the character value can be  such as (cat|cow|coyote), 1 is returned, and the character value can be
1447  retrieved using PCRE_INFO_FIRSTLITERAL.  retrieved using PCRE_INFO_FIRSTCHARACTER.
1448  .P  .P
1449  If there is no fixed first value, and if either  If there is no fixed first value, and if either
1450  .sp  .sp
# Line 1458  starts with "^", or Line 1458  starts with "^", or
1458  subject string or after any newline within the string. Otherwise 0 is  subject string or after any newline within the string. Otherwise 0 is
1459  returned. For anchored patterns, 0 is returned.  returned. For anchored patterns, 0 is returned.
1460  .sp  .sp
1461    PCRE_INFO_FIRSTLITERAL    PCRE_INFO_FIRSTCHARACTER
1462  .sp  .sp
1463  Return the fixed first character value, if PCRE_INFO_FIRSTLITERALSET returned 1;  Return the fixed first character value, if PCRE_INFO_FIRSTCHARACTERFLAGS returned 1;
1464  otherwise returns 0. The fourth argument should point to an \fBuint_t\fP  otherwise returns 0. The fourth argument should point to an \fBuint_t\fP
1465  variable.  variable.
1466  .P  .P
# Line 1480  starts with "^", or Line 1480  starts with "^", or
1480  subject string or after any newline within the string. Otherwise -2 is  subject string or after any newline within the string. Otherwise -2 is
1481  returned. For anchored patterns, -2 is returned.  returned. For anchored patterns, -2 is returned.
1482  .sp  .sp
1483    PCRE_INFO_LASTLITERAL2SET    PCRE_INFO_REQUIREDCHARFLAGS
1484  .sp  .sp
1485  Returns 1 if there is a rightmost literal data unit that must exist in any matched  Returns 1 if there is a rightmost literal data unit that must exist in any matched
1486  string, other than at its start. The fourth argument should  point to an \fBint\fP  string, other than at its start. The fourth argument should  point to an \fBint\fP
1487  variable. If there is no such value, 0 is returned. If returning 1, the character  variable. If there is no such value, 0 is returned. If returning 1, the character
1488  value itself can be retrieved using PCRE_INFO_LASTLITERAL2.  value itself can be retrieved using PCRE_INFO_REQUIREDCHAR.
1489  .P  .P
1490  For anchored patterns, a last literal value is recorded only if it follows something  For anchored patterns, a last literal value is recorded only if it follows something
1491  of variable length. For example, for the pattern /^a\ed+z\ed+/ the returned value  of variable length. For example, for the pattern /^a\ed+z\ed+/ the returned value
1492  1 (with "z" returned from PCRE_INFO_LASTLITERAL2), but for /^a\edz\ed/ the returned  1 (with "z" returned from PCRE_INFO_REQUIREDCHAR), but for /^a\edz\ed/ the returned
1493  value is 0.  value is 0.
1494  .sp  .sp
1495    PCRE_INFO_LASTLITERAL2    PCRE_INFO_REQUIREDCHAR
1496  .sp  .sp
1497  Return the value of the rightmost literal data unit that must exist in any  Return the value of the rightmost literal data unit that must exist in any
1498  matched string, other than at its start, if such a value has been recorded. The  matched string, other than at its start, if such a value has been recorded. The

Legend:
Removed from v.1112  
changed lines
  Added in v.1113

  ViewVC Help
Powered by ViewVC 1.1.5