/[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 155 by ph10, Tue Apr 24 13:36:11 2007 UTC revision 191 by ph10, Mon Jul 30 11:13:54 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 871  table indicating a fixed set of bytes fo Line 874  table indicating a fixed set of bytes fo
874  string, a pointer to the table is returned. Otherwise NULL is returned. The  string, a pointer to the table is returned. Otherwise NULL is returned. The
875  fourth argument should point to an \fBunsigned char *\fP variable.  fourth argument should point to an \fBunsigned char *\fP variable.
876  .sp  .sp
877      PCRE_INFO_JCHANGED
878    .sp
879    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
881    setting changes the local PCRE_DUPNAMES option.
882    .sp
883    PCRE_INFO_LASTLITERAL    PCRE_INFO_LASTLITERAL
884  .sp  .sp
885  Return the value of the rightmost literal byte that must exist in any matched  Return the value of the rightmost literal byte that must exist in any matched
# Line 923  When writing code to extract data from n Line 932  When writing code to extract data from n
932  name-to-number map, remember that the length of the entries is likely to be  name-to-number map, remember that the length of the entries is likely to be
933  different for each compiled pattern.  different for each compiled pattern.
934  .sp  .sp
935      PCRE_INFO_OKPARTIAL
936    .sp
937    Return 1 if the pattern can be used for partial matching, otherwise 0. The
938    fourth argument should point to an \fBint\fP variable. The
939    .\" HREF
940    \fBpcrepartial\fP
941    .\"
942    documentation lists the restrictions that apply to patterns when partial
943    matching is used.
944    .sp
945    PCRE_INFO_OPTIONS    PCRE_INFO_OPTIONS
946  .sp  .sp
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
# Line 1446  description above. Line 1465  description above.
1465  .sp  .sp
1466    PCRE_ERROR_NULLWSLIMIT    (-22)    PCRE_ERROR_NULLWSLIMIT    (-22)
1467  .sp  .sp
1468  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
1469  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
1470  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
1471  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
1472  given.  an empty string is matched.
1473    .P
1474    Some workspace is required for remembering the starting position. For most
1475    capturing subpatterns, an internal recursive call of the match() function is
1476    used, and in this case, the workspace is taken from the runtime stack. However,
1477    for non-capturing subpatterns, this is not available. Instead, some fixed
1478    workspace (taken from the top-level stack) is used. If it runs out, the
1479    PCRE_ERROR_NULLWSLIMIT error is given. The size of the fixed workspace allows
1480    for up to 1000 repetitions of a non-capturing subpattern that might match an
1481    empty string. If this limit is a problem for you, you can sometimes get round
1482    it by changing a non-capturing subpattern into a capturing one, but that will
1483    increase the amount of runtime stack that is used.
1484  .sp  .sp
1485    PCRE_ERROR_BADNEWLINE     (-23)    PCRE_ERROR_BADNEWLINE     (-23)
1486  .sp  .sp
# Line 1851  Cambridge CB2 3QH, England. Line 1881  Cambridge CB2 3QH, England.
1881  .rs  .rs
1882  .sp  .sp
1883  .nf  .nf
1884  Last updated: 24 April 2007  Last updated: 30 July 2007
1885  Copyright (c) 1997-2007 University of Cambridge.  Copyright (c) 1997-2007 University of Cambridge.
1886  .fi  .fi

Legend:
Removed from v.155  
changed lines
  Added in v.191

  ViewVC Help
Powered by ViewVC 1.1.5