/[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 181 by ph10, Wed Jun 13 14:55:18 2007 UTC revision 196 by ph10, Mon Jul 30 13:44:50 2007 UTC
# 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  \g is not followed by a braced name or an optionally braced    57  \eg is not followed by a braced name or an optionally braced
680          non-zero number          non-zero number
681    58  (?+ or (?- or (?(+ or (?(- must be followed by a non-zero number    58  (?+ or (?- or (?(+ or (?(- must be followed by a non-zero number
682  .  .
# Line 947  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 1465  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 1870  Cambridge CB2 3QH, England. Line 1884  Cambridge CB2 3QH, England.
1884  .rs  .rs
1885  .sp  .sp
1886  .nf  .nf
1887  Last updated: 13 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.181  
changed lines
  Added in v.196

  ViewVC Help
Powered by ViewVC 1.1.5