/[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 172 by ph10, Tue Jun 5 10:40:13 2007 UTC revision 196 by ph10, Mon Jul 30 13:44:50 2007 UTC
# Line 648  out of use. To avoid confusion, they hav Line 648  out of use. To avoid confusion, they hav
648    26  malformed number or name after (?(    26  malformed number or name after (?(
649    27  conditional group contains more than two branches    27  conditional group contains more than two branches
650    28  assertion expected after (?(    28  assertion expected after (?(
651    29  (?R or (?digits must be followed by )    29  (?R or (?[+-]digits must be followed by )
652    30  unknown POSIX class name    30  unknown POSIX class name
653    31  POSIX collating elements are not supported    31  POSIX collating elements are not supported
654    32  this version of PCRE is not compiled with PCRE_UTF8 support    32  this version of PCRE is not compiled with PCRE_UTF8 support
# Line 676  out of use. To avoid confusion, they hav Line 676  out of use. To avoid confusion, they hav
676    54  DEFINE group contains more than one branch    54  DEFINE group contains more than one branch
677    55  repeating a DEFINE group is not allowed    55  repeating a DEFINE group is not allowed
678    56  inconsistent NEWLINE options"    56  inconsistent NEWLINE options"
679      57  \eg is not followed by a braced name or an optionally braced
680            non-zero number
681      58  (?+ or (?- or (?(+ or (?(- must be followed by a non-zero number
682  .  .
683  .  .
684  .SH "STUDYING A PATTERN"  .SH "STUDYING A PATTERN"
# Line 875  fourth argument should point to an \fBun Line 878  fourth argument should point to an \fBun
878  .sp  .sp
879  Return 1 if the (?J) option setting is used in the pattern, otherwise 0. The  Return 1 if the (?J) option setting is used in the pattern, otherwise 0. The
880  fourth argument should point to an \fBint\fP variable. The (?J) internal option  fourth argument should point to an \fBint\fP variable. The (?J) internal option
881  setting changes the local PCRE_DUPNAMES value.  setting changes the local PCRE_DUPNAMES option.
882  .sp  .sp
883    PCRE_INFO_LASTLITERAL    PCRE_INFO_LASTLITERAL
884  .sp  .sp
# Line 944  matching is used. Line 947  matching is used.
947  Return a copy of the options with which the pattern was compiled. The fourth  Return a copy of the options with which the pattern was compiled. The fourth
948  argument should point to an \fBunsigned long int\fP variable. These option bits  argument should point to an \fBunsigned long int\fP variable. These option bits
949  are those specified in the call to \fBpcre_compile()\fP, modified by any  are those specified in the call to \fBpcre_compile()\fP, modified by any
950  top-level option settings within the pattern itself.  top-level option settings at the start of the pattern itself. In other words,
951    they are the options that will be in force when matching starts. For example,
952    if the pattern /(?im)abc(?-i)d/ is compiled with the PCRE_EXTENDED option, the
953    result is PCRE_CASELESS, PCRE_MULTILINE, and PCRE_EXTENDED.
954  .P  .P
955  A pattern is automatically anchored by PCRE if all of its top-level  A pattern is automatically anchored by PCRE if all of its top-level
956  alternatives begin with one of the following:  alternatives begin with one of the following:
# Line 1462  description above. Line 1468  description above.
1468  .sp  .sp
1469    PCRE_ERROR_NULLWSLIMIT    (-22)    PCRE_ERROR_NULLWSLIMIT    (-22)
1470  .sp  .sp
1471  When a group that can match an empty substring is repeated with an unbounded  When a parenthesized subpattern that can match an empty substring is repeated
1472  upper limit, the subject position at the start of the group must be remembered,  with an unbounded upper limit, the subject position at the start of the group
1473  so that a test for an empty string can be made when the end of the group is  must be remembered, so that a test for an empty string can be made when the end
1474  reached. Some workspace is required for this; if it runs out, this error is  of the group is reached. The repetition loop is automatically terminated when
1475  given.  an empty string is matched.
1476    .P
1477    Some workspace is required for remembering the starting position. For most
1478    capturing subpatterns, an internal recursive call of the match() function is
1479    used, and in this case, the workspace is taken from the runtime stack. However,
1480    for non-capturing subpatterns, this is not available. Instead, some fixed
1481    workspace (taken from the top-level stack) is used. If it runs out, the
1482    PCRE_ERROR_NULLWSLIMIT error is given. The size of the fixed workspace allows
1483    for up to 1000 repetitions of a non-capturing subpattern that might match an
1484    empty string. If this limit is a problem for you, you can sometimes get round
1485    it by changing a non-capturing subpattern into a capturing one, but that will
1486    increase the amount of runtime stack that is used.
1487  .sp  .sp
1488    PCRE_ERROR_BADNEWLINE     (-23)    PCRE_ERROR_BADNEWLINE     (-23)
1489  .sp  .sp
# Line 1867  Cambridge CB2 3QH, England. Line 1884  Cambridge CB2 3QH, England.
1884  .rs  .rs
1885  .sp  .sp
1886  .nf  .nf
1887  Last updated: 04 June 2007  Last updated: 30 July 2007
1888  Copyright (c) 1997-2007 University of Cambridge.  Copyright (c) 1997-2007 University of Cambridge.
1889  .fi  .fi
Legend:
Removed from v.172  
changed lines
  Added in v.196
webmaster@exim.org
 ViewVC Help
Powered by ViewVC 1.1.12