--- 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. +
The external callout function returns an integer to PCRE. If the value is zero, @@ -206,9 +214,9 @@
-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.