/[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 682 by ph10, Sun Aug 28 15:23:03 2011 UTC revision 683 by ph10, Tue Sep 6 10:37:15 2011 UTC
# Line 1823  return from the function is 2, because t Line 1823  return from the function is 2, because t
1823  number is 1, and the offsets for for the second and third capturing subpatterns  number is 1, and the offsets for for the second and third capturing subpatterns
1824  (assuming the vector is large enough, of course) are set to -1.  (assuming the vector is large enough, of course) are set to -1.
1825  .P  .P
1826  \fBNote\fP: Elements of \fIovector\fP that do not correspond to capturing  \fBNote\fP: Elements in the first two-thids of \fIovector\fP that do not
1827  parentheses in the pattern are never changed. That is, if a pattern contains  correspond to capturing parentheses in the pattern are never changed. That is,
1828  \fIn\fP capturing parentheses, no more than \fIovector[0]\fP to  if a pattern contains \fIn\fP capturing parentheses, no more than
1829  \fIovector[2n+1]\fP are set by \fBpcre_exec()\fP. The other elements retain  \fIovector[0]\fP to \fIovector[2n+1]\fP are set by \fBpcre_exec()\fP. The other
1830  whatever values they previously had.  elements (in the first two-thirds) retain whatever values they previously had.
1831  .P  .P
1832  Some convenience functions are provided for extracting the captured substrings  Some convenience functions are provided for extracting the captured substrings
1833  as separate strings. These are described below.  as separate strings. These are described below.
# Line 2428  returns data, even though the meaning of Line 2428  returns data, even though the meaning of
2428  The strings are returned in reverse order of length; that is, the longest  The strings are returned in reverse order of length; that is, the longest
2429  matching string is given first. If there were too many matches to fit into  matching string is given first. If there were too many matches to fit into
2430  \fIovector\fP, the yield of the function is zero, and the vector is filled with  \fIovector\fP, the yield of the function is zero, and the vector is filled with
2431  the longest matches.  the longest matches. Unlike \fBpcre_exec()\fP, \fBpcre_dfa_exec()\fP can use
2432    the entire \fIovector\fP for returning matched strings.
2433  .  .
2434  .  .
2435  .SS "Error returns from \fBpcre_dfa_exec()\fP"  .SS "Error returns from \fBpcre_dfa_exec()\fP"
# Line 2497  Cambridge CB2 3QH, England. Line 2498  Cambridge CB2 3QH, England.
2498  .rs  .rs
2499  .sp  .sp
2500  .nf  .nf
2501  Last updated: 27 August 2011  Last updated: 29 August 2011
2502  Copyright (c) 1997-2011 University of Cambridge.  Copyright (c) 1997-2011 University of Cambridge.
2503  .fi  .fi
Legend:
Removed from v.682  
changed lines
  Added in v.683
webmaster@exim.org
 ViewVC Help
Powered by ViewVC 1.1.12