/[pcre]/code/trunk/pcre.h.in
ViewVC logotype

Diff of /code/trunk/pcre.h.in

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

revision 117 by ph10, Fri Mar 9 15:59:06 2007 UTC revision 1055 by chpe, Tue Oct 16 15:53:30 2012 UTC
# Line 5  Line 5 
5  /* This is the public header file for the PCRE library, to be #included by  /* This is the public header file for the PCRE library, to be #included by
6  applications that call the PCRE functions.  applications that call the PCRE functions.
7    
8             Copyright (c) 1997-2007 University of Cambridge             Copyright (c) 1997-2012 University of Cambridge
9    
10  -----------------------------------------------------------------------------  -----------------------------------------------------------------------------
11  Redistribution and use in source and binary forms, with or without  Redistribution and use in source and binary forms, with or without
# Line 46  POSSIBILITY OF SUCH DAMAGE. Line 46  POSSIBILITY OF SUCH DAMAGE.
46  #define PCRE_PRERELEASE     @PCRE_PRERELEASE@  #define PCRE_PRERELEASE     @PCRE_PRERELEASE@
47  #define PCRE_DATE           @PCRE_DATE@  #define PCRE_DATE           @PCRE_DATE@
48    
49  /* Win32 uses DLL by default; it needs special stuff for exported functions  /* When an application links to a PCRE DLL in Windows, the symbols that are
50  when building PCRE. */  imported have to be identified as such. When building PCRE, the appropriate
51    export setting is defined in pcre_internal.h, which includes this file. So we
52  #ifdef _WIN32  don't change existing definitions of PCRE_EXP_DECL and PCRECPP_EXP_DECL. */
53  #  ifdef PCRE_DEFINITION  
54  #    ifdef DLL_EXPORT  #if defined(_WIN32) && !defined(PCRE_STATIC)
55  #      define PCRE_DATA_SCOPE __declspec(dllexport)  #  ifndef PCRE_EXP_DECL
56    #    define PCRE_EXP_DECL  extern __declspec(dllimport)
57    #  endif
58    #  ifdef __cplusplus
59    #    ifndef PCRECPP_EXP_DECL
60    #      define PCRECPP_EXP_DECL  extern __declspec(dllimport)
61  #    endif  #    endif
62  #  else  #    ifndef PCRECPP_EXP_DEFN
63  #    ifndef PCRE_STATIC  #      define PCRECPP_EXP_DEFN  __declspec(dllimport)
 #      define PCRE_DATA_SCOPE extern __declspec(dllimport)  
64  #    endif  #    endif
65  #  endif  #  endif
66  #endif  #endif
67    
68  /* Otherwise, we use the standard "extern". */  /* By default, we use the standard "extern" declarations. */
69    
70  #ifndef PCRE_DATA_SCOPE  #ifndef PCRE_EXP_DECL
71  #  ifdef __cplusplus  #  ifdef __cplusplus
72  #    define PCRE_DATA_SCOPE     extern "C"  #    define PCRE_EXP_DECL  extern "C"
73  #  else  #  else
74  #    define PCRE_DATA_SCOPE     extern  #    define PCRE_EXP_DECL  extern
75    #  endif
76    #endif
77    
78    #ifdef __cplusplus
79    #  ifndef PCRECPP_EXP_DECL
80    #    define PCRECPP_EXP_DECL  extern
81    #  endif
82    #  ifndef PCRECPP_EXP_DEFN
83    #    define PCRECPP_EXP_DEFN
84  #  endif  #  endif
85  #endif  #endif
86    
# Line 82  it is needed here for malloc. */ Line 95  it is needed here for malloc. */
95  extern "C" {  extern "C" {
96  #endif  #endif
97    
98  /* Options */  /* Options. Some are compile-time only, some are run-time only, and some are
99    both, so we keep them all distinct. However, almost all the bits in the options
100  #define PCRE_CASELESS           0x00000001  word are now used. In the long run, we may have to re-use some of the
101  #define PCRE_MULTILINE          0x00000002  compile-time only bits for runtime options, or vice versa. In the comments
102  #define PCRE_DOTALL             0x00000004  below, "compile", "exec", and "DFA exec" mean that the option is permitted to
103  #define PCRE_EXTENDED           0x00000008  be set for those functions; "used in" means that an option may be set only for
104  #define PCRE_ANCHORED           0x00000010  compile, but is subsequently referenced in exec and/or DFA exec. Any of the
105  #define PCRE_DOLLAR_ENDONLY     0x00000020  compile-time options may be inspected during studying (and therefore JIT
106  #define PCRE_EXTRA              0x00000040  compiling). */
107  #define PCRE_NOTBOL             0x00000080  
108  #define PCRE_NOTEOL             0x00000100  #define PCRE_CASELESS           0x00000001  /* Compile */
109  #define PCRE_UNGREEDY           0x00000200  #define PCRE_MULTILINE          0x00000002  /* Compile */
110  #define PCRE_NOTEMPTY           0x00000400  #define PCRE_DOTALL             0x00000004  /* Compile */
111  #define PCRE_UTF8               0x00000800  #define PCRE_EXTENDED           0x00000008  /* Compile */
112  #define PCRE_NO_AUTO_CAPTURE    0x00001000  #define PCRE_ANCHORED           0x00000010  /* Compile, exec, DFA exec */
113  #define PCRE_NO_UTF8_CHECK      0x00002000  #define PCRE_DOLLAR_ENDONLY     0x00000020  /* Compile, used in exec, DFA exec */
114  #define PCRE_AUTO_CALLOUT       0x00004000  #define PCRE_EXTRA              0x00000040  /* Compile */
115  #define PCRE_PARTIAL            0x00008000  #define PCRE_NOTBOL             0x00000080  /* Exec, DFA exec */
116  #define PCRE_DFA_SHORTEST       0x00010000  #define PCRE_NOTEOL             0x00000100  /* Exec, DFA exec */
117  #define PCRE_DFA_RESTART        0x00020000  #define PCRE_UNGREEDY           0x00000200  /* Compile */
118  #define PCRE_FIRSTLINE          0x00040000  #define PCRE_NOTEMPTY           0x00000400  /* Exec, DFA exec */
119  #define PCRE_DUPNAMES           0x00080000  /* The next two are also used in exec and DFA exec */
120  #define PCRE_NEWLINE_CR         0x00100000  #define PCRE_UTF8               0x00000800  /* Compile (same as PCRE_UTF16 and PCRE_UTF32) */
121  #define PCRE_NEWLINE_LF         0x00200000  #define PCRE_UTF16              0x00000800  /* Compile (same as PCRE_UTF8 and PCRE_UTF32) */
122  #define PCRE_NEWLINE_CRLF       0x00300000  #define PCRE_UTF32              0x00000800  /* Compile (same as PCRE_UTF8 and PCRE_UTF16) */
123  #define PCRE_NEWLINE_ANY        0x00400000  #define PCRE_NO_AUTO_CAPTURE    0x00001000  /* Compile */
124    /* The next two are also used in exec and DFA exec */
125    #define PCRE_NO_UTF8_CHECK      0x00002000  /* Compile (same as PCRE_NO_UTF16_CHECK and PCRE_NO_UTF32_CHECK) */
126    #define PCRE_NO_UTF16_CHECK     0x00002000  /* Compile (same as PCRE_NO_UTF8_CHECK and PCRE_NO_UTF32_CHECK) */
127    #define PCRE_NO_UTF32_CHECK     0x00002000  /* Compile (same as PCRE_NO_UTF8_CHECK and PCRE_NO_UTF16_CHECK) */
128    #define PCRE_AUTO_CALLOUT       0x00004000  /* Compile */
129    #define PCRE_PARTIAL_SOFT       0x00008000  /* Exec, DFA exec */
130    #define PCRE_PARTIAL            0x00008000  /* Backwards compatible synonym */
131    #define PCRE_DFA_SHORTEST       0x00010000  /* DFA exec */
132    #define PCRE_DFA_RESTART        0x00020000  /* DFA exec */
133    #define PCRE_FIRSTLINE          0x00040000  /* Compile, used in exec, DFA exec */
134    #define PCRE_DUPNAMES           0x00080000  /* Compile */
135    #define PCRE_NEWLINE_CR         0x00100000  /* Compile, exec, DFA exec */
136    #define PCRE_NEWLINE_LF         0x00200000  /* Compile, exec, DFA exec */
137    #define PCRE_NEWLINE_CRLF       0x00300000  /* Compile, exec, DFA exec */
138    #define PCRE_NEWLINE_ANY        0x00400000  /* Compile, exec, DFA exec */
139    #define PCRE_NEWLINE_ANYCRLF    0x00500000  /* Compile, exec, DFA exec */
140    #define PCRE_BSR_ANYCRLF        0x00800000  /* Compile, exec, DFA exec */
141    #define PCRE_BSR_UNICODE        0x01000000  /* Compile, exec, DFA exec */
142    #define PCRE_JAVASCRIPT_COMPAT  0x02000000  /* Compile, used in exec */
143    #define PCRE_NO_START_OPTIMIZE  0x04000000  /* Compile, exec, DFA exec */
144    #define PCRE_NO_START_OPTIMISE  0x04000000  /* Synonym */
145    #define PCRE_PARTIAL_HARD       0x08000000  /* Exec, DFA exec */
146    #define PCRE_NOTEMPTY_ATSTART   0x10000000  /* Exec, DFA exec */
147    #define PCRE_UCP                0x20000000  /* Compile, used in exec, DFA exec */
148    
149  /* Exec-time and get/set-time error codes */  /* Exec-time and get/set-time error codes */
150    
151  #define PCRE_ERROR_NOMATCH         (-1)  #define PCRE_ERROR_NOMATCH          (-1)
152  #define PCRE_ERROR_NULL            (-2)  #define PCRE_ERROR_NULL             (-2)
153  #define PCRE_ERROR_BADOPTION       (-3)  #define PCRE_ERROR_BADOPTION        (-3)
154  #define PCRE_ERROR_BADMAGIC        (-4)  #define PCRE_ERROR_BADMAGIC         (-4)
155  #define PCRE_ERROR_UNKNOWN_OPCODE  (-5)  #define PCRE_ERROR_UNKNOWN_OPCODE   (-5)
156  #define PCRE_ERROR_UNKNOWN_NODE    (-5)  /* For backward compatibility */  #define PCRE_ERROR_UNKNOWN_NODE     (-5)  /* For backward compatibility */
157  #define PCRE_ERROR_NOMEMORY        (-6)  #define PCRE_ERROR_NOMEMORY         (-6)
158  #define PCRE_ERROR_NOSUBSTRING     (-7)  #define PCRE_ERROR_NOSUBSTRING      (-7)
159  #define PCRE_ERROR_MATCHLIMIT      (-8)  #define PCRE_ERROR_MATCHLIMIT       (-8)
160  #define PCRE_ERROR_CALLOUT         (-9)  /* Never used by PCRE itself */  #define PCRE_ERROR_CALLOUT          (-9)  /* Never used by PCRE itself */
161  #define PCRE_ERROR_BADUTF8        (-10)  #define PCRE_ERROR_BADUTF8         (-10)  /* Same for 8/16/32 */
162  #define PCRE_ERROR_BADUTF8_OFFSET (-11)  #define PCRE_ERROR_BADUTF16        (-10)  /* Same for 8/16/32 */
163  #define PCRE_ERROR_PARTIAL        (-12)  #define PCRE_ERROR_BADUTF32        (-10)  /* Same for 8/16/32 */
164  #define PCRE_ERROR_BADPARTIAL     (-13)  #define PCRE_ERROR_BADUTF8_OFFSET  (-11)  /* Same for 8/16/32 */
165  #define PCRE_ERROR_INTERNAL       (-14)  #define PCRE_ERROR_BADUTF16_OFFSET (-11)  /* Same for 8/16/32 */
166  #define PCRE_ERROR_BADCOUNT       (-15)  #define PCRE_ERROR_BADUTF32_OFFSET (-11)  /* Same for 8/16/32 */
167  #define PCRE_ERROR_DFA_UITEM      (-16)  #define PCRE_ERROR_PARTIAL         (-12)
168  #define PCRE_ERROR_DFA_UCOND      (-17)  #define PCRE_ERROR_BADPARTIAL      (-13)
169  #define PCRE_ERROR_DFA_UMLIMIT    (-18)  #define PCRE_ERROR_INTERNAL        (-14)
170  #define PCRE_ERROR_DFA_WSSIZE     (-19)  #define PCRE_ERROR_BADCOUNT        (-15)
171  #define PCRE_ERROR_DFA_RECURSE    (-20)  #define PCRE_ERROR_DFA_UITEM       (-16)
172  #define PCRE_ERROR_RECURSIONLIMIT (-21)  #define PCRE_ERROR_DFA_UCOND       (-17)
173  #define PCRE_ERROR_NULLWSLIMIT    (-22)  #define PCRE_ERROR_DFA_UMLIMIT     (-18)
174  #define PCRE_ERROR_BADNEWLINE     (-23)  #define PCRE_ERROR_DFA_WSSIZE      (-19)
175    #define PCRE_ERROR_DFA_RECURSE     (-20)
176    #define PCRE_ERROR_RECURSIONLIMIT  (-21)
177    #define PCRE_ERROR_NULLWSLIMIT     (-22)  /* No longer actually used */
178    #define PCRE_ERROR_BADNEWLINE      (-23)
179    #define PCRE_ERROR_BADOFFSET       (-24)
180    #define PCRE_ERROR_SHORTUTF8       (-25)
181    #define PCRE_ERROR_SHORTUTF16      (-25)  /* Same for 8/16 */
182    #define PCRE_ERROR_RECURSELOOP     (-26)
183    #define PCRE_ERROR_JIT_STACKLIMIT  (-27)
184    #define PCRE_ERROR_BADMODE         (-28)
185    #define PCRE_ERROR_BADENDIANNESS   (-29)
186    #define PCRE_ERROR_DFA_BADRESTART  (-30)
187    
188    /* Specific error codes for UTF-8 validity checks */
189    
190    #define PCRE_UTF8_ERR0               0
191    #define PCRE_UTF8_ERR1               1
192    #define PCRE_UTF8_ERR2               2
193    #define PCRE_UTF8_ERR3               3
194    #define PCRE_UTF8_ERR4               4
195    #define PCRE_UTF8_ERR5               5
196    #define PCRE_UTF8_ERR6               6
197    #define PCRE_UTF8_ERR7               7
198    #define PCRE_UTF8_ERR8               8
199    #define PCRE_UTF8_ERR9               9
200    #define PCRE_UTF8_ERR10             10
201    #define PCRE_UTF8_ERR11             11
202    #define PCRE_UTF8_ERR12             12
203    #define PCRE_UTF8_ERR13             13
204    #define PCRE_UTF8_ERR14             14
205    #define PCRE_UTF8_ERR15             15
206    #define PCRE_UTF8_ERR16             16
207    #define PCRE_UTF8_ERR17             17
208    #define PCRE_UTF8_ERR18             18
209    #define PCRE_UTF8_ERR19             19
210    #define PCRE_UTF8_ERR20             20
211    #define PCRE_UTF8_ERR21             21
212    
213    /* Specific error codes for UTF-16 validity checks */
214    
215    #define PCRE_UTF16_ERR0              0
216    #define PCRE_UTF16_ERR1              1
217    #define PCRE_UTF16_ERR2              2
218    #define PCRE_UTF16_ERR3              3
219    #define PCRE_UTF16_ERR4              4
220    
221    /* Specific error codes for UTF-32 validity checks */
222    
223    #define PCRE_UTF32_ERR0              0
224    #define PCRE_UTF32_ERR1              1
225    #define PCRE_UTF32_ERR2              2
226    
227  /* Request types for pcre_fullinfo() */  /* Request types for pcre_fullinfo() */
228    
# Line 151  extern "C" { Line 239  extern "C" {
239  #define PCRE_INFO_NAMETABLE          9  #define PCRE_INFO_NAMETABLE          9
240  #define PCRE_INFO_STUDYSIZE         10  #define PCRE_INFO_STUDYSIZE         10
241  #define PCRE_INFO_DEFAULT_TABLES    11  #define PCRE_INFO_DEFAULT_TABLES    11
242    #define PCRE_INFO_OKPARTIAL         12
243    #define PCRE_INFO_JCHANGED          13
244    #define PCRE_INFO_HASCRORLF         14
245    #define PCRE_INFO_MINLENGTH         15
246    #define PCRE_INFO_JIT               16
247    #define PCRE_INFO_JITSIZE           17
248    #define PCRE_INFO_MAXLOOKBEHIND     18
249    
250  /* Request types for pcre_config(). Do not re-arrange, in order to remain  /* Request types for pcre_config(). Do not re-arrange, in order to remain
251  compatible. */  compatible. */
# Line 163  compatible. */ Line 258  compatible. */
258  #define PCRE_CONFIG_STACKRECURSE            5  #define PCRE_CONFIG_STACKRECURSE            5
259  #define PCRE_CONFIG_UNICODE_PROPERTIES      6  #define PCRE_CONFIG_UNICODE_PROPERTIES      6
260  #define PCRE_CONFIG_MATCH_LIMIT_RECURSION   7  #define PCRE_CONFIG_MATCH_LIMIT_RECURSION   7
261    #define PCRE_CONFIG_BSR                     8
262    #define PCRE_CONFIG_JIT                     9
263    #define PCRE_CONFIG_UTF16                  10
264    #define PCRE_CONFIG_JITTARGET              11
265    #define PCRE_CONFIG_UTF32                  12
266    
267  /* Bit flags for the pcre_extra structure. Do not re-arrange or redefine  /* Request types for pcre_study(). Do not re-arrange, in order to remain
268    compatible. */
269    
270    #define PCRE_STUDY_JIT_COMPILE                0x0001
271    #define PCRE_STUDY_JIT_PARTIAL_SOFT_COMPILE   0x0002
272    #define PCRE_STUDY_JIT_PARTIAL_HARD_COMPILE   0x0004
273    #define PCRE_STUDY_EXTRA_NEEDED               0x0008
274    
275    /* Bit flags for the pcre[16|32]_extra structure. Do not re-arrange or redefine
276  these bits, just add new ones on the end, in order to remain compatible. */  these bits, just add new ones on the end, in order to remain compatible. */
277    
278  #define PCRE_EXTRA_STUDY_DATA             0x0001  #define PCRE_EXTRA_STUDY_DATA             0x0001
# Line 172  these bits, just add new ones on the end Line 280  these bits, just add new ones on the end
280  #define PCRE_EXTRA_CALLOUT_DATA           0x0004  #define PCRE_EXTRA_CALLOUT_DATA           0x0004
281  #define PCRE_EXTRA_TABLES                 0x0008  #define PCRE_EXTRA_TABLES                 0x0008
282  #define PCRE_EXTRA_MATCH_LIMIT_RECURSION  0x0010  #define PCRE_EXTRA_MATCH_LIMIT_RECURSION  0x0010
283    #define PCRE_EXTRA_MARK                   0x0020
284    #define PCRE_EXTRA_EXECUTABLE_JIT         0x0040
285    
286  /* Types */  /* Types */
287    
288  struct real_pcre;                 /* declaration; the definition is private  */  struct real_pcre;                 /* declaration; the definition is private  */
289  typedef struct real_pcre pcre;  typedef struct real_pcre pcre;
290    
291    struct real_pcre16;               /* declaration; the definition is private  */
292    typedef struct real_pcre16 pcre16;
293    
294    struct real_pcre32;               /* declaration; the definition is private  */
295    typedef struct real_pcre32 pcre32;
296    
297    struct real_pcre_jit_stack;       /* declaration; the definition is private  */
298    typedef struct real_pcre_jit_stack pcre_jit_stack;
299    
300    struct real_pcre16_jit_stack;     /* declaration; the definition is private  */
301    typedef struct real_pcre16_jit_stack pcre16_jit_stack;
302    
303    struct real_pcre32_jit_stack;     /* declaration; the definition is private  */
304    typedef struct real_pcre32_jit_stack pcre32_jit_stack;
305    
306    /* If PCRE is compiled with 16 bit character support, PCRE_UCHAR16 must contain
307    a 16 bit wide signed data type. Otherwise it can be a dummy data type since
308    pcre16 functions are not implemented. There is a check for this in pcre_internal.h. */
309    #ifndef PCRE_UCHAR16
310    #define PCRE_UCHAR16 unsigned short
311    #endif
312    
313    #ifndef PCRE_SPTR16
314    #define PCRE_SPTR16 const PCRE_UCHAR16 *
315    #endif
316    
317    /* If PCRE is compiled with 32 bit character support, PCRE_UCHAR32 must contain
318    a 32 bit wide signed data type. Otherwise it can be a dummy data type since
319    pcre32 functions are not implemented. There is a check for this in pcre_internal.h. */
320    #ifndef PCRE_UCHAR32
321    #define PCRE_UCHAR32 unsigned int
322    #endif
323    
324    #ifndef PCRE_SPTR32
325    #define PCRE_SPTR32 const PCRE_UCHAR32 *
326    #endif
327    
328  /* When PCRE is compiled as a C++ library, the subject pointer type can be  /* When PCRE is compiled as a C++ library, the subject pointer type can be
329  replaced with a custom type. For conventional use, the public interface is a  replaced with a custom type. For conventional use, the public interface is a
330  const char *. */  const char *. */
# Line 197  typedef struct pcre_extra { Line 344  typedef struct pcre_extra {
344    void *callout_data;             /* Data passed back in callouts */    void *callout_data;             /* Data passed back in callouts */
345    const unsigned char *tables;    /* Pointer to character tables */    const unsigned char *tables;    /* Pointer to character tables */
346    unsigned long int match_limit_recursion; /* Max recursive calls to match() */    unsigned long int match_limit_recursion; /* Max recursive calls to match() */
347      unsigned char **mark;           /* For passing back a mark pointer */
348      void *executable_jit;           /* Contains a pointer to a compiled jit code */
349  } pcre_extra;  } pcre_extra;
350    
351    /* Same structure as above, but with 16 bit char pointers. */
352    
353    typedef struct pcre16_extra {
354      unsigned long int flags;        /* Bits for which fields are set */
355      void *study_data;               /* Opaque data from pcre_study() */
356      unsigned long int match_limit;  /* Maximum number of calls to match() */
357      void *callout_data;             /* Data passed back in callouts */
358      const unsigned char *tables;    /* Pointer to character tables */
359      unsigned long int match_limit_recursion; /* Max recursive calls to match() */
360      PCRE_UCHAR16 **mark;            /* For passing back a mark pointer */
361      void *executable_jit;           /* Contains a pointer to a compiled jit code */
362    } pcre16_extra;
363    
364    /* Same structure as above, but with 32 bit char pointers. */
365    
366    typedef struct pcre32_extra {
367      unsigned long int flags;        /* Bits for which fields are set */
368      void *study_data;               /* Opaque data from pcre_study() */
369      unsigned long int match_limit;  /* Maximum number of calls to match() */
370      void *callout_data;             /* Data passed back in callouts */
371      const unsigned char *tables;    /* Pointer to character tables */
372      unsigned long int match_limit_recursion; /* Max recursive calls to match() */
373      PCRE_UCHAR32 **mark;            /* For passing back a mark pointer */
374      void *executable_jit;           /* Contains a pointer to a compiled jit code */
375    } pcre32_extra;
376    
377  /* The structure for passing out data via the pcre_callout_function. We use a  /* The structure for passing out data via the pcre_callout_function. We use a
378  structure so that new fields can be added on the end in future versions,  structure so that new fields can be added on the end in future versions,
379  without changing the API of the function, thereby allowing old clients to work  without changing the API of the function, thereby allowing old clients to work
# Line 219  typedef struct pcre_callout_block { Line 394  typedef struct pcre_callout_block {
394    /* ------------------- Added for Version 1 -------------------------- */    /* ------------------- Added for Version 1 -------------------------- */
395    int          pattern_position;  /* Offset to next item in the pattern */    int          pattern_position;  /* Offset to next item in the pattern */
396    int          next_item_length;  /* Length of next item in the pattern */    int          next_item_length;  /* Length of next item in the pattern */
397      /* ------------------- Added for Version 2 -------------------------- */
398      const unsigned char *mark;      /* Pointer to current mark or NULL    */
399    /* ------------------------------------------------------------------ */    /* ------------------------------------------------------------------ */
400  } pcre_callout_block;  } pcre_callout_block;
401    
402    /* Same structure as above, but with 16 bit char pointers. */
403    
404    typedef struct pcre16_callout_block {
405      int          version;           /* Identifies version of block */
406      /* ------------------------ Version 0 ------------------------------- */
407      int          callout_number;    /* Number compiled into pattern */
408      int         *offset_vector;     /* The offset vector */
409      PCRE_SPTR16  subject;           /* The subject being matched */
410      int          subject_length;    /* The length of the subject */
411      int          start_match;       /* Offset to start of this match attempt */
412      int          current_position;  /* Where we currently are in the subject */
413      int          capture_top;       /* Max current capture */
414      int          capture_last;      /* Most recently closed capture */
415      void        *callout_data;      /* Data passed in with the call */
416      /* ------------------- Added for Version 1 -------------------------- */
417      int          pattern_position;  /* Offset to next item in the pattern */
418      int          next_item_length;  /* Length of next item in the pattern */
419      /* ------------------- Added for Version 2 -------------------------- */
420      const PCRE_UCHAR16 *mark;       /* Pointer to current mark or NULL    */
421      /* ------------------------------------------------------------------ */
422    } pcre16_callout_block;
423    
424    /* Same structure as above, but with 32 bit char pointers. */
425    
426    typedef struct pcre32_callout_block {
427      int          version;           /* Identifies version of block */
428      /* ------------------------ Version 0 ------------------------------- */
429      int          callout_number;    /* Number compiled into pattern */
430      int         *offset_vector;     /* The offset vector */
431      PCRE_SPTR32  subject;           /* The subject being matched */
432      int          subject_length;    /* The length of the subject */
433      int          start_match;       /* Offset to start of this match attempt */
434      int          current_position;  /* Where we currently are in the subject */
435      int          capture_top;       /* Max current capture */
436      int          capture_last;      /* Most recently closed capture */
437      void        *callout_data;      /* Data passed in with the call */
438      /* ------------------- Added for Version 1 -------------------------- */
439      int          pattern_position;  /* Offset to next item in the pattern */
440      int          next_item_length;  /* Length of next item in the pattern */
441      /* ------------------- Added for Version 2 -------------------------- */
442      const PCRE_UCHAR32 *mark;       /* Pointer to current mark or NULL    */
443      /* ------------------------------------------------------------------ */
444    } pcre32_callout_block;
445    
446  /* Indirection for store get and free functions. These can be set to  /* Indirection for store get and free functions. These can be set to
447  alternative malloc/free functions if required. Special ones are used in the  alternative malloc/free functions if required. Special ones are used in the
448  non-recursive case for "frames". There is also an optional callout function  non-recursive case for "frames". There is also an optional callout function
# Line 229  that is triggered by the (?) regex item. Line 450  that is triggered by the (?) regex item.
450  have to take another form. */  have to take another form. */
451    
452  #ifndef VPCOMPAT  #ifndef VPCOMPAT
453  PCRE_DATA_SCOPE void *(*pcre_malloc)(size_t);  PCRE_EXP_DECL void *(*pcre_malloc)(size_t);
454  PCRE_DATA_SCOPE void  (*pcre_free)(void *);  PCRE_EXP_DECL void  (*pcre_free)(void *);
455  PCRE_DATA_SCOPE void *(*pcre_stack_malloc)(size_t);  PCRE_EXP_DECL void *(*pcre_stack_malloc)(size_t);
456  PCRE_DATA_SCOPE void  (*pcre_stack_free)(void *);  PCRE_EXP_DECL void  (*pcre_stack_free)(void *);
457  PCRE_DATA_SCOPE int   (*pcre_callout)(pcre_callout_block *);  PCRE_EXP_DECL int   (*pcre_callout)(pcre_callout_block *);
458    
459    PCRE_EXP_DECL void *(*pcre16_malloc)(size_t);
460    PCRE_EXP_DECL void  (*pcre16_free)(void *);
461    PCRE_EXP_DECL void *(*pcre16_stack_malloc)(size_t);
462    PCRE_EXP_DECL void  (*pcre16_stack_free)(void *);
463    PCRE_EXP_DECL int   (*pcre16_callout)(pcre16_callout_block *);
464    
465    PCRE_EXP_DECL void *(*pcre32_malloc)(size_t);
466    PCRE_EXP_DECL void  (*pcre32_free)(void *);
467    PCRE_EXP_DECL void *(*pcre32_stack_malloc)(size_t);
468    PCRE_EXP_DECL void  (*pcre32_stack_free)(void *);
469    PCRE_EXP_DECL int   (*pcre32_callout)(pcre32_callout_block *);
470  #else   /* VPCOMPAT */  #else   /* VPCOMPAT */
471  PCRE_DATA_SCOPE void *pcre_malloc(size_t);  PCRE_EXP_DECL void *pcre_malloc(size_t);
472  PCRE_DATA_SCOPE void  pcre_free(void *);  PCRE_EXP_DECL void  pcre_free(void *);
473  PCRE_DATA_SCOPE void *pcre_stack_malloc(size_t);  PCRE_EXP_DECL void *pcre_stack_malloc(size_t);
474  PCRE_DATA_SCOPE void  pcre_stack_free(void *);  PCRE_EXP_DECL void  pcre_stack_free(void *);
475  PCRE_DATA_SCOPE int   pcre_callout(pcre_callout_block *);  PCRE_EXP_DECL int   pcre_callout(pcre_callout_block *);
476    
477    PCRE_EXP_DECL void *pcre16_malloc(size_t);
478    PCRE_EXP_DECL void  pcre16_free(void *);
479    PCRE_EXP_DECL void *pcre16_stack_malloc(size_t);
480    PCRE_EXP_DECL void  pcre16_stack_free(void *);
481    PCRE_EXP_DECL int   pcre16_callout(pcre16_callout_block *);
482    
483    PCRE_EXP_DECL void *pcre32_malloc(size_t);
484    PCRE_EXP_DECL void  pcre32_free(void *);
485    PCRE_EXP_DECL void *pcre32_stack_malloc(size_t);
486    PCRE_EXP_DECL void  pcre32_stack_free(void *);
487    PCRE_EXP_DECL int   pcre32_callout(pcre32_callout_block *);
488  #endif  /* VPCOMPAT */  #endif  /* VPCOMPAT */
489    
490    /* User defined callback which provides a stack just before the match starts. */
491    
492    typedef pcre_jit_stack *(*pcre_jit_callback)(void *);
493    typedef pcre16_jit_stack *(*pcre16_jit_callback)(void *);
494    typedef pcre32_jit_stack *(*pcre32_jit_callback)(void *);
495    
496  /* Exported PCRE functions */  /* Exported PCRE functions */
497    
498  PCRE_DATA_SCOPE pcre *pcre_compile(const char *, int, const char **, int *,  PCRE_EXP_DECL pcre *pcre_compile(const char *, int, const char **, int *,
499                    const unsigned char *);                    const unsigned char *);
500  PCRE_DATA_SCOPE pcre *pcre_compile2(const char *, int, int *, const char **,  PCRE_EXP_DECL pcre16 *pcre16_compile(PCRE_SPTR16, int, const char **, int *,
501                      const unsigned char *);
502    PCRE_EXP_DECL pcre32 *pcre32_compile(PCRE_SPTR32, int, const char **, int *,
503                      const unsigned char *);
504    PCRE_EXP_DECL pcre *pcre_compile2(const char *, int, int *, const char **,
505                      int *, const unsigned char *);
506    PCRE_EXP_DECL pcre16 *pcre16_compile2(PCRE_SPTR16, int, int *, const char **,
507                    int *, const unsigned char *);                    int *, const unsigned char *);
508  PCRE_DATA_SCOPE int  pcre_config(int, void *);  PCRE_EXP_DECL pcre32 *pcre32_compile2(PCRE_SPTR32, int, int *, const char **,
509  PCRE_DATA_SCOPE int  pcre_copy_named_substring(const pcre *, const char *,                    int *, const unsigned char *);
510    PCRE_EXP_DECL int  pcre_config(int, void *);
511    PCRE_EXP_DECL int  pcre16_config(int, void *);
512    PCRE_EXP_DECL int  pcre32_config(int, void *);
513    PCRE_EXP_DECL int  pcre_copy_named_substring(const pcre *, const char *,
514                    int *, int, const char *, char *, int);                    int *, int, const char *, char *, int);
515  PCRE_DATA_SCOPE int  pcre_copy_substring(const char *, int *, int, int, char *,  PCRE_EXP_DECL int  pcre16_copy_named_substring(const pcre16 *, PCRE_SPTR16,
516                    int);                    int *, int, PCRE_SPTR16, PCRE_UCHAR16 *, int);
517  PCRE_DATA_SCOPE int  pcre_dfa_exec(const pcre *, const pcre_extra *,  PCRE_EXP_DECL int  pcre32_copy_named_substring(const pcre32 *, PCRE_SPTR32,
518                      int *, int, PCRE_SPTR32, PCRE_UCHAR32 *, int);
519    PCRE_EXP_DECL int  pcre_copy_substring(const char *, int *, int, int,
520                      char *, int);
521    PCRE_EXP_DECL int  pcre16_copy_substring(PCRE_SPTR16, int *, int, int,
522                      PCRE_UCHAR16 *, int);
523    PCRE_EXP_DECL int  pcre32_copy_substring(PCRE_SPTR32, int *, int, int,
524                      PCRE_UCHAR32 *, int);
525    PCRE_EXP_DECL int  pcre_dfa_exec(const pcre *, const pcre_extra *,
526                    const char *, int, int, int, int *, int , int *, int);                    const char *, int, int, int, int *, int , int *, int);
527  PCRE_DATA_SCOPE int  pcre_exec(const pcre *, const pcre_extra *, PCRE_SPTR,  PCRE_EXP_DECL int  pcre16_dfa_exec(const pcre16 *, const pcre16_extra *,
528                      PCRE_SPTR16, int, int, int, int *, int , int *, int);
529    PCRE_EXP_DECL int  pcre32_dfa_exec(const pcre32 *, const pcre32_extra *,
530                      PCRE_SPTR32, int, int, int, int *, int , int *, int);
531    PCRE_EXP_DECL int  pcre_exec(const pcre *, const pcre_extra *, PCRE_SPTR,
532                     int, int, int, int *, int);                     int, int, int, int *, int);
533  PCRE_DATA_SCOPE void pcre_free_substring(const char *);  PCRE_EXP_DECL int  pcre16_exec(const pcre16 *, const pcre16_extra *,
534  PCRE_DATA_SCOPE void pcre_free_substring_list(const char **);                     PCRE_SPTR16, int, int, int, int *, int);
535  PCRE_DATA_SCOPE int  pcre_fullinfo(const pcre *, const pcre_extra *, int,  PCRE_EXP_DECL int  pcre32_exec(const pcre32 *, const pcre32_extra *,
536                       PCRE_SPTR32, int, int, int, int *, int);
537    PCRE_EXP_DECL void pcre_free_substring(const char *);
538    PCRE_EXP_DECL void pcre16_free_substring(PCRE_SPTR16);
539    PCRE_EXP_DECL void pcre32_free_substring(PCRE_SPTR32);
540    PCRE_EXP_DECL void pcre_free_substring_list(const char **);
541    PCRE_EXP_DECL void pcre16_free_substring_list(PCRE_SPTR16 *);
542    PCRE_EXP_DECL void pcre32_free_substring_list(PCRE_SPTR32 *);
543    PCRE_EXP_DECL int  pcre_fullinfo(const pcre *, const pcre_extra *, int,
544                      void *);
545    PCRE_EXP_DECL int  pcre16_fullinfo(const pcre16 *, const pcre16_extra *, int,
546                    void *);                    void *);
547  PCRE_DATA_SCOPE int  pcre_get_named_substring(const pcre *, const char *,  PCRE_EXP_DECL int  pcre32_fullinfo(const pcre32 *, const pcre32_extra *, int,
548                      void *);
549    PCRE_EXP_DECL int  pcre_get_named_substring(const pcre *, const char *,
550                    int *, int, const char *, const char **);                    int *, int, const char *, const char **);
551  PCRE_DATA_SCOPE int  pcre_get_stringnumber(const pcre *, const char *);  PCRE_EXP_DECL int  pcre16_get_named_substring(const pcre16 *, PCRE_SPTR16,
552  PCRE_DATA_SCOPE int  pcre_get_stringtable_entries(const pcre *, const char *,                    int *, int, PCRE_SPTR16, PCRE_SPTR16 *);
553    PCRE_EXP_DECL int  pcre32_get_named_substring(const pcre32 *, PCRE_SPTR32,
554                      int *, int, PCRE_SPTR32, PCRE_SPTR32 *);
555    PCRE_EXP_DECL int  pcre_get_stringnumber(const pcre *, const char *);
556    PCRE_EXP_DECL int  pcre16_get_stringnumber(const pcre16 *, PCRE_SPTR16);
557    PCRE_EXP_DECL int  pcre32_get_stringnumber(const pcre32 *, PCRE_SPTR32);
558    PCRE_EXP_DECL int  pcre_get_stringtable_entries(const pcre *, const char *,
559                    char **, char **);                    char **, char **);
560  PCRE_DATA_SCOPE int  pcre_get_substring(const char *, int *, int, int,  PCRE_EXP_DECL int  pcre16_get_stringtable_entries(const pcre16 *, PCRE_SPTR16,
561                      PCRE_UCHAR16 **, PCRE_UCHAR16 **);
562    PCRE_EXP_DECL int  pcre32_get_stringtable_entries(const pcre32 *, PCRE_SPTR32,
563                      PCRE_UCHAR32 **, PCRE_UCHAR32 **);
564    PCRE_EXP_DECL int  pcre_get_substring(const char *, int *, int, int,
565                    const char **);                    const char **);
566  PCRE_DATA_SCOPE int  pcre_get_substring_list(const char *, int *, int,  PCRE_EXP_DECL int  pcre16_get_substring(PCRE_SPTR16, int *, int, int,
567                      PCRE_SPTR16 *);
568    PCRE_EXP_DECL int  pcre32_get_substring(PCRE_SPTR32, int *, int, int,
569                      PCRE_SPTR32 *);
570    PCRE_EXP_DECL int  pcre_get_substring_list(const char *, int *, int,
571                    const char ***);                    const char ***);
572  PCRE_DATA_SCOPE int  pcre_info(const pcre *, int *, int *);  PCRE_EXP_DECL int  pcre16_get_substring_list(PCRE_SPTR16, int *, int,
573  PCRE_DATA_SCOPE const unsigned char *pcre_maketables(void);                    PCRE_SPTR16 **);
574  PCRE_DATA_SCOPE int  pcre_refcount(pcre *, int);  PCRE_EXP_DECL int  pcre32_get_substring_list(PCRE_SPTR32, int *, int,
575  PCRE_DATA_SCOPE pcre_extra *pcre_study(const pcre *, int, const char **);                    PCRE_SPTR32 **);
576  PCRE_DATA_SCOPE const char *pcre_version(void);  PCRE_EXP_DECL const unsigned char *pcre_maketables(void);
577    PCRE_EXP_DECL const unsigned char *pcre16_maketables(void);
578    PCRE_EXP_DECL const unsigned char *pcre32_maketables(void);
579    PCRE_EXP_DECL int  pcre_refcount(pcre *, int);
580    PCRE_EXP_DECL int  pcre16_refcount(pcre16 *, int);
581    PCRE_EXP_DECL int  pcre32_refcount(pcre32 *, int);
582    PCRE_EXP_DECL pcre_extra *pcre_study(const pcre *, int, const char **);
583    PCRE_EXP_DECL pcre16_extra *pcre16_study(const pcre16 *, int, const char **);
584    PCRE_EXP_DECL pcre32_extra *pcre32_study(const pcre32 *, int, const char **);
585    PCRE_EXP_DECL void pcre_free_study(pcre_extra *);
586    PCRE_EXP_DECL void pcre16_free_study(pcre16_extra *);
587    PCRE_EXP_DECL void pcre32_free_study(pcre32_extra *);
588    PCRE_EXP_DECL const char *pcre_version(void);
589    PCRE_EXP_DECL const char *pcre16_version(void);
590    PCRE_EXP_DECL const char *pcre32_version(void);
591    
592    /* Utility functions for byte order swaps. */
593    PCRE_EXP_DECL int  pcre_pattern_to_host_byte_order(pcre *, pcre_extra *,
594                      const unsigned char *);
595    PCRE_EXP_DECL int  pcre16_pattern_to_host_byte_order(pcre16 *, pcre16_extra *,
596                      const unsigned char *);
597    PCRE_EXP_DECL int  pcre32_pattern_to_host_byte_order(pcre32 *, pcre32_extra *,
598                      const unsigned char *);
599    PCRE_EXP_DECL int  pcre16_utf16_to_host_byte_order(PCRE_UCHAR16 *,
600                      PCRE_SPTR16, int, int *, int);
601    PCRE_EXP_DECL int  pcre32_utf32_to_host_byte_order(PCRE_UCHAR32 *,
602                      PCRE_SPTR32, int, int *, int);
603    
604    /* JIT compiler related functions. */
605    
606    PCRE_EXP_DECL pcre_jit_stack *pcre_jit_stack_alloc(int, int);
607    PCRE_EXP_DECL pcre16_jit_stack *pcre16_jit_stack_alloc(int, int);
608    PCRE_EXP_DECL pcre32_jit_stack *pcre32_jit_stack_alloc(int, int);
609    PCRE_EXP_DECL void pcre_jit_stack_free(pcre_jit_stack *);
610    PCRE_EXP_DECL void pcre16_jit_stack_free(pcre16_jit_stack *);
611    PCRE_EXP_DECL void pcre32_jit_stack_free(pcre32_jit_stack *);
612    PCRE_EXP_DECL void pcre_assign_jit_stack(pcre_extra *,
613                      pcre_jit_callback, void *);
614    PCRE_EXP_DECL void pcre16_assign_jit_stack(pcre16_extra *,
615                      pcre16_jit_callback, void *);
616    PCRE_EXP_DECL void pcre32_assign_jit_stack(pcre32_extra *,
617                      pcre32_jit_callback, void *);
618    
619  #ifdef __cplusplus  #ifdef __cplusplus
620  }  /* extern "C" */  }  /* extern "C" */

Legend:
Removed from v.117  
changed lines
  Added in v.1055

  ViewVC Help
Powered by ViewVC 1.1.5