/[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 150 by ph10, Tue Apr 17 08:22:40 2007 UTC revision 197 by ph10, Tue Jul 31 10:50:18 2007 UTC
# Line 265  which it was compiled. Details are given Line 265  which it was compiled. Details are given
265  .\" HREF  .\" HREF
266  \fBpcreprecompile\fP  \fBpcreprecompile\fP
267  .\"  .\"
268  documentation.  documentation. However, compiling a regular expression with one version of PCRE
269    for use with a different version is not guaranteed to work and may cause
270    crashes.
271  .  .
272  .  .
273  .SH "CHECKING BUILD-TIME OPTIONS"  .SH "CHECKING BUILD-TIME OPTIONS"
# Line 646  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 674  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 869  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 921  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
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 1442  The internal recursion limit, as specifi Line 1466  The internal recursion limit, as specifi
1466  field in a \fBpcre_extra\fP structure (or defaulted) was reached. See the  field in a \fBpcre_extra\fP structure (or defaulted) was reached. See the
1467  description above.  description above.
1468  .sp  .sp
   PCRE_ERROR_NULLWSLIMIT    (-22)  
 .sp  
 When a group that can match an empty substring is repeated with an unbounded  
 upper limit, the subject position at the start of the group must be remembered,  
 so that a test for an empty string can be made when the end of the group is  
 reached. Some workspace is required for this; if it runs out, this error is  
 given.  
 .sp  
1469    PCRE_ERROR_BADNEWLINE     (-23)    PCRE_ERROR_BADNEWLINE     (-23)
1470  .sp  .sp
1471  An invalid combination of PCRE_NEWLINE_\fIxxx\fP options was given.  An invalid combination of PCRE_NEWLINE_\fIxxx\fP options was given.
1472  .P  .P
1473  Error numbers -16 to -20 are not used by \fBpcre_exec()\fP.  Error numbers -16 to -20 and -22 are not used by \fBpcre_exec()\fP.
1474  .  .
1475  .  .
1476  .SH "EXTRACTING CAPTURED SUBSTRINGS BY NUMBER"  .SH "EXTRACTING CAPTURED SUBSTRINGS BY NUMBER"
# Line 1849  Cambridge CB2 3QH, England. Line 1865  Cambridge CB2 3QH, England.
1865  .rs  .rs
1866  .sp  .sp
1867  .nf  .nf
1868  Last updated: 16 April 2007  Last updated: 30 July 2007
1869  Copyright (c) 1997-2007 University of Cambridge.  Copyright (c) 1997-2007 University of Cambridge.
1870  .fi  .fi

Legend:
Removed from v.150  
changed lines
  Added in v.197

  ViewVC Help
Powered by ViewVC 1.1.5