/[pcre]/code/trunk/doc/pcrecallout.3
ViewVC logotype

Diff of /code/trunk/doc/pcrecallout.3

Parent Directory Parent Directory | Revision Log Revision Log | View Patch Patch

revision 79 by nigel, Sat Feb 24 21:40:52 2007 UTC revision 168 by ph10, Tue May 29 15:18:18 2007 UTC
# Line 17  function is to be called. Different call Line 17  function is to be called. Different call
17  a number less than 256 after the letter C. The default value is zero.  a number less than 256 after the letter C. The default value is zero.
18  For example, this pattern has two callout points:  For example, this pattern has two callout points:
19  .sp  .sp
20    (?C1)\deabc(?C2)def    (?C1)abc(?C2)def
21  .sp  .sp
22  If the PCRE_AUTO_CALLOUT option bit is set when \fBpcre_compile()\fP is called,  If the PCRE_AUTO_CALLOUT option bit is set when \fBpcre_compile()\fP is called,
23  PCRE automatically inserts callouts, all with number 255, before each item in  PCRE automatically inserts callouts, all with number 255, before each item in
# Line 95  not useful. Line 95  not useful.
95  The \fIsubject\fP and \fIsubject_length\fP fields contain copies of the values  The \fIsubject\fP and \fIsubject_length\fP fields contain copies of the values
96  that were passed to \fBpcre_exec()\fP.  that were passed to \fBpcre_exec()\fP.
97  .P  .P
98  The \fIstart_match\fP field contains the offset within the subject at which the  The \fIstart_match\fP field normally contains the offset within the subject at
99  current match attempt started. If the pattern is not anchored, the callout  which the current match attempt started. However, if the escape sequence \eK
100  function may be called several times from the same point in the pattern for  has been encountered, this value is changed to reflect the modified starting
101  different starting points in the subject.  point. If the pattern is not anchored, the callout function may be called
102    several times from the same point in the pattern for different starting points
103    in the subject.
104  .P  .P
105  The \fIcurrent_position\fP field contains the offset within the subject of the  The \fIcurrent_position\fP field contains the offset within the subject of the
106  current match pointer.  current match pointer.
# Line 154  Negative values should normally be chose Line 156  Negative values should normally be chose
156  values. In particular, PCRE_ERROR_NOMATCH forces a standard "no match" failure.  values. In particular, PCRE_ERROR_NOMATCH forces a standard "no match" failure.
157  The error number PCRE_ERROR_CALLOUT is reserved for use by callout functions;  The error number PCRE_ERROR_CALLOUT is reserved for use by callout functions;
158  it will never be used by PCRE itself.  it will never be used by PCRE itself.
159  .P  .
160  .in 0  .
161  Last updated: 28 February 2005  .SH AUTHOR
162  .br  .rs
163  Copyright (c) 1997-2005 University of Cambridge.  .sp
164    .nf
165    Philip Hazel
166    University Computing Service
167    Cambridge CB2 3QH, England.
168    .fi
169    .
170    .
171    .SH REVISION
172    .rs
173    .sp
174    .nf
175    Last updated: 29 May 2007
176    Copyright (c) 1997-2007 University of Cambridge.
177    .fi

Legend:
Removed from v.79  
changed lines
  Added in v.168

  ViewVC Help
Powered by ViewVC 1.1.5