--- code/trunk/doc/html/pcrecallout.html 2010/11/24 17:39:25 579 +++ code/trunk/doc/html/pcrecallout.html 2011/08/02 11:00:40 654 @@ -93,21 +93,22 @@ only argument to the callout function is a pointer to a pcre_callout block. This structure contains the following fields:
-  int          version;
-  int          callout_number;
-  int         *offset_vector;
-  const char  *subject;
-  int          subject_length;
-  int          start_match;
-  int          current_position;
-  int          capture_top;
-  int          capture_last;
-  void        *callout_data;
-  int          pattern_position;
-  int          next_item_length;
+  int         version;
+  int         callout_number;
+  int        *offset_vector;
+  const char *subject;
+  int         subject_length;
+  int         start_match;
+  int         current_position;
+  int         capture_top;
+  int         capture_last;
+  void       *callout_data;
+  int         pattern_position;
+  int         next_item_length;
+  const unsigned char *mark;
 
The version field is an integer containing the version number of the -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 number will change again in future if additional fields are added, but the intention is never to remove any of the existing fields.

@@ -180,6 +181,13 @@ help in distinguishing between different automatic callouts, which all have the same callout number. However, they are set for all callouts.

+

+The mark field is present from version 2 of the pcre_callout +structure. In callouts from pcre_exec() it contains a pointer to the +zero-terminated name of the most recently passed (*MARK) item in the match, or +NULL if there are no (*MARK)s in the current matching path. In callouts from +pcre_dfa_exec() this field always contains NULL. +


RETURN VALUES

The external callout function returns an integer to PCRE. If the value is zero, @@ -206,9 +214,9 @@


REVISION

-Last updated: 21 November 2010 +Last updated: 31 July 2011
-Copyright © 1997-2010 University of Cambridge. +Copyright © 1997-2011 University of Cambridge.

Return to the PCRE index page.