/[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 644 by ph10, Sun Nov 21 18:51:22 2010 UTC revision 645 by ph10, Sun Jul 31 17:02:18 2011 UTC
# Line 75  the \fBpcre_exec()\fP and the \fBpcre_df Line 75  the \fBpcre_exec()\fP and the \fBpcre_df
75  only argument to the callout function is a pointer to a \fBpcre_callout\fP  only argument to the callout function is a pointer to a \fBpcre_callout\fP
76  block. This structure contains the following fields:  block. This structure contains the following fields:
77  .sp  .sp
78    int          \fIversion\fP;    int         \fIversion\fP;
79    int          \fIcallout_number\fP;    int         \fIcallout_number\fP;
80    int         *\fIoffset_vector\fP;    int        *\fIoffset_vector\fP;
81    const char  *\fIsubject\fP;    const char *\fIsubject\fP;
82    int          \fIsubject_length\fP;    int         \fIsubject_length\fP;
83    int          \fIstart_match\fP;    int         \fIstart_match\fP;
84    int          \fIcurrent_position\fP;    int         \fIcurrent_position\fP;
85    int          \fIcapture_top\fP;    int         \fIcapture_top\fP;
86    int          \fIcapture_last\fP;    int         \fIcapture_last\fP;
87    void        *\fIcallout_data\fP;    void       *\fIcallout_data\fP;
88    int          \fIpattern_position\fP;    int         \fIpattern_position\fP;
89    int          \fInext_item_length\fP;    int         \fInext_item_length\fP;
90      const unsigned char *\fImark\fP;
91  .sp  .sp
92  The \fIversion\fP field is an integer containing the version number of the  The \fIversion\fP field is an integer containing the version number of the
93  block format. The initial version was 0; the current version is 1. The version  block format. The initial version was 0; the current version is 2. The version
94  number will change again in future if additional fields are added, but the  number will change again in future if additional fields are added, but the
95  intention is never to remove any of the existing fields.  intention is never to remove any of the existing fields.
96  .P  .P
# Line 152  of the entire subpattern. Line 153  of the entire subpattern.
153  The \fIpattern_position\fP and \fInext_item_length\fP fields are intended to  The \fIpattern_position\fP and \fInext_item_length\fP fields are intended to
154  help in distinguishing between different automatic callouts, which all have the  help in distinguishing between different automatic callouts, which all have the
155  same callout number. However, they are set for all callouts.  same callout number. However, they are set for all callouts.
156    .P
157    The \fImark\fP field is present from version 2 of the \fIpcre_callout\fP
158    structure. In callouts from \fBpcre_exec()\fP it contains a pointer to the
159    zero-terminated name of the most recently passed (*MARK) item in the match, or
160    NULL if there are no (*MARK)s in the current matching path. In callouts from
161    \fBpcre_dfa_exec()\fP this field always contains NULL.
162  .  .
163  .  .
164  .SH "RETURN VALUES"  .SH "RETURN VALUES"
# Line 184  Cambridge CB2 3QH, England. Line 191  Cambridge CB2 3QH, England.
191  .rs  .rs
192  .sp  .sp
193  .nf  .nf
194  Last updated: 21 November 2010  Last updated: 31 July 2011
195  Copyright (c) 1997-2010 University of Cambridge.  Copyright (c) 1997-2011 University of Cambridge.
196  .fi  .fi
Legend:
Removed from v.644  
changed lines
  Added in v.645
  ViewVC Help
Powered by ViewVC 1.1.5