/[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 691 by ph10, Sun Sep 11 14:31:21 2011 UTC revision 788 by ph10, Tue Dec 6 15:38:01 2011 UTC
# Line 643  character). Thus, the pattern AB]CD beco Line 643  character). Thus, the pattern AB]CD beco
643  string (by default this causes the current matching alternative to fail). A  string (by default this causes the current matching alternative to fail). A
644  pattern such as (\e1)(a) succeeds when this option is set (assuming it can find  pattern such as (\e1)(a) succeeds when this option is set (assuming it can find
645  an "a" in the subject), whereas it fails by default, for Perl compatibility.  an "a" in the subject), whereas it fails by default, for Perl compatibility.
646    .P
647    (3) \eU matches an upper case "U" character; by default \eU causes a compile
648    time error (Perl uses \eU to upper case subsequent characters).
649    .P
650    (4) \eu matches a lower case "u" character unless it is followed by four
651    hexadecimal digits, in which case the hexadecimal number defines the code point
652    to match. By default, \eu causes a compile time error (Perl uses it to upper
653    case the following character).
654    .P
655    (5) \ex matches a lower case "x" character unless it is followed by two
656    hexadecimal digits, in which case the hexadecimal number defines the code point
657    to match. By default, as in Perl, a hexadecimal number is always expected after
658    \ex, but it may have zero, one, or two digits (so, for example, \exz matches a
659    binary zero character followed by z).
660  .sp  .sp
661    PCRE_MULTILINE    PCRE_MULTILINE
662  .sp  .sp
# Line 1133  particular pattern. See the Line 1147  particular pattern. See the
1147  .\"  .\"
1148  documentation for details of what can and cannot be handled.  documentation for details of what can and cannot be handled.
1149  .sp  .sp
1150      PCRE_INFO_JITSIZE
1151    .sp
1152    If the pattern was successfully studied with the PCRE_STUDY_JIT_COMPILE option,
1153    return the size of the JIT compiled code, otherwise return zero. The fourth
1154    argument should point to a \fBsize_t\fP variable.
1155    .sp
1156    PCRE_INFO_LASTLITERAL    PCRE_INFO_LASTLITERAL
1157  .sp  .sp
1158  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 1248  For such patterns, the PCRE_ANCHORED bit Line 1268  For such patterns, the PCRE_ANCHORED bit
1268  .sp  .sp
1269    PCRE_INFO_SIZE    PCRE_INFO_SIZE
1270  .sp  .sp
1271  Return the size of the compiled pattern, that is, the value that was passed as  Return the size of the compiled pattern. The fourth argument should point to a
1272  the argument to \fBpcre_malloc()\fP when PCRE was getting memory in which to  \fBsize_t\fP variable. This value does not include the size of the \fBpcre\fP
1273  place the compiled data. The fourth argument should point to a \fBsize_t\fP  structure that is returned by \fBpcre_compile()\fP. The value that is passed as
1274  variable.  the argument to \fBpcre_malloc()\fP when \fBpcre_compile()\fP is getting memory
1275    in which to place the compiled data is the value returned by this option plus
1276    the size of the \fBpcre\fP structure. Studying a compiled pattern, with or
1277    without JIT, does not alter the value returned by this option.
1278  .sp  .sp
1279    PCRE_INFO_STUDYSIZE    PCRE_INFO_STUDYSIZE
1280  .sp  .sp
# Line 1331  is different. (This seems a highly unlik Line 1354  is different. (This seems a highly unlik
1354  The function \fBpcre_exec()\fP is called to match a subject string against a  The function \fBpcre_exec()\fP is called to match a subject string against a
1355  compiled pattern, which is passed in the \fIcode\fP argument. If the  compiled pattern, which is passed in the \fIcode\fP argument. If the
1356  pattern was studied, the result of the study should be passed in the  pattern was studied, the result of the study should be passed in the
1357  \fIextra\fP argument. This function is the main matching facility of the  \fIextra\fP argument. You can call \fBpcre_exec()\fP with the same \fIcode\fP
1358  library, and it operates in a Perl-like manner. For specialist use there is  and \fIextra\fP arguments as many times as you like, in order to match
1359  also an alternative matching function, which is described  different subject strings with the same pattern.
1360    .P
1361    This function is the main matching facility of the library, and it operates in
1362    a Perl-like manner. For specialist use there is also an alternative matching
1363    function, which is described
1364  .\" HTML <a href="#dfamatch">  .\" HTML <a href="#dfamatch">
1365  .\" </a>  .\" </a>
1366  below  below
# Line 2526  Cambridge CB2 3QH, England. Line 2553  Cambridge CB2 3QH, England.
2553  .rs  .rs
2554  .sp  .sp
2555  .nf  .nf
2556  Last updated: 06 September 2011  Last updated: 02 December 2011
2557  Copyright (c) 1997-2011 University of Cambridge.  Copyright (c) 1997-2011 University of Cambridge.
2558  .fi  .fi

Legend:
Removed from v.691  
changed lines
  Added in v.788

  ViewVC Help
Powered by ViewVC 1.1.5