/[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 553 by ph10, Fri Oct 22 15:57:50 2010 UTC revision 1309 by ph10, Fri Apr 5 15:35:59 2013 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-2010 University of Cambridge             Copyright (c) 1997-2013 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 95  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. Some are compile-time only, some are run-time only, and some are  /* Public options. Some are compile-time only, some are run-time only, and some
99  both, so we keep them all distinct. However, almost all the bits in the options  are both. Most of the compile-time options are saved with the compiled regex so
100  word are now used. In the long run, we may have to re-use some of the  that they can be inspected during studying (and therefore JIT compiling). Note
101  compile-time only bits for runtime options, or vice versa. */  that pcre_study() has its own set of options. Originally, all the options
102    defined here used distinct bits. However, almost all the bits in a 32-bit word
103  #define PCRE_CASELESS           0x00000001  /* Compile */  are now used, so in order to conserve them, option bits that were previously
104  #define PCRE_MULTILINE          0x00000002  /* Compile */  only recognized at matching time (i.e. by pcre_exec() or pcre_dfa_exec()) may
105  #define PCRE_DOTALL             0x00000004  /* Compile */  also be used for compile-time options that affect only compiling and are not
106  #define PCRE_EXTENDED           0x00000008  /* Compile */  relevant for studying or JIT compiling.
107  #define PCRE_ANCHORED           0x00000010  /* Compile, exec, DFA exec */  
108  #define PCRE_DOLLAR_ENDONLY     0x00000020  /* Compile */  Some options for pcre_compile() change its behaviour but do not affect the
109  #define PCRE_EXTRA              0x00000040  /* Compile */  behaviour of the execution functions. Other options are passed through to the
110  #define PCRE_NOTBOL             0x00000080  /* Exec, DFA exec */  execution functions and affect their behaviour, with or without affecting the
111  #define PCRE_NOTEOL             0x00000100  /* Exec, DFA exec */  behaviour of pcre_compile().
112  #define PCRE_UNGREEDY           0x00000200  /* Compile */  
113  #define PCRE_NOTEMPTY           0x00000400  /* Exec, DFA exec */  Options that can be passed to pcre_compile() are tagged Cx below, with these
114  #define PCRE_UTF8               0x00000800  /* Compile */  variants:
115  #define PCRE_NO_AUTO_CAPTURE    0x00001000  /* Compile */  
116  #define PCRE_NO_UTF8_CHECK      0x00002000  /* Compile, exec, DFA exec */  C1   Affects compile only
117  #define PCRE_AUTO_CALLOUT       0x00004000  /* Compile */  C2   Does not affect compile; affects exec, dfa_exec
118  #define PCRE_PARTIAL_SOFT       0x00008000  /* Exec, DFA exec */  C3   Affects compile, exec, dfa_exec
119  #define PCRE_PARTIAL            0x00008000  /* Backwards compatible synonym */  C4   Affects compile, exec, dfa_exec, study
120  #define PCRE_DFA_SHORTEST       0x00010000  /* DFA exec */  C5   Affects compile, exec, study
121  #define PCRE_DFA_RESTART        0x00020000  /* DFA exec */  
122  #define PCRE_FIRSTLINE          0x00040000  /* Compile */  Options that can be set for pcre_exec() and/or pcre_dfa_exec() are flagged with
123  #define PCRE_DUPNAMES           0x00080000  /* Compile */  E and D, respectively. They take precedence over C3, C4, and C5 settings passed
124  #define PCRE_NEWLINE_CR         0x00100000  /* Compile, exec, DFA exec */  from pcre_compile(). Those that are compatible with JIT execution are flagged
125  #define PCRE_NEWLINE_LF         0x00200000  /* Compile, exec, DFA exec */  with J. */
126  #define PCRE_NEWLINE_CRLF       0x00300000  /* Compile, exec, DFA exec */  
127  #define PCRE_NEWLINE_ANY        0x00400000  /* Compile, exec, DFA exec */  #define PCRE_CASELESS           0x00000001  /* C1       */
128  #define PCRE_NEWLINE_ANYCRLF    0x00500000  /* Compile, exec, DFA exec */  #define PCRE_MULTILINE          0x00000002  /* C1       */
129  #define PCRE_BSR_ANYCRLF        0x00800000  /* Compile, exec, DFA exec */  #define PCRE_DOTALL             0x00000004  /* C1       */
130  #define PCRE_BSR_UNICODE        0x01000000  /* Compile, exec, DFA exec */  #define PCRE_EXTENDED           0x00000008  /* C1       */
131  #define PCRE_JAVASCRIPT_COMPAT  0x02000000  /* Compile */  #define PCRE_ANCHORED           0x00000010  /* C4 E D   */
132  #define PCRE_NO_START_OPTIMIZE  0x04000000  /* Exec, DFA exec */  #define PCRE_DOLLAR_ENDONLY     0x00000020  /* C2       */
133  #define PCRE_NO_START_OPTIMISE  0x04000000  /* Synonym */  #define PCRE_EXTRA              0x00000040  /* C1       */
134  #define PCRE_PARTIAL_HARD       0x08000000  /* Exec, DFA exec */  #define PCRE_NOTBOL             0x00000080  /*    E D J */
135  #define PCRE_NOTEMPTY_ATSTART   0x10000000  /* Exec, DFA exec */  #define PCRE_NOTEOL             0x00000100  /*    E D J */
136  #define PCRE_UCP                0x20000000  /* Compile */  #define PCRE_UNGREEDY           0x00000200  /* C1       */
137    #define PCRE_NOTEMPTY           0x00000400  /*    E D J */
138    #define PCRE_UTF8               0x00000800  /* C4        )          */
139    #define PCRE_UTF16              0x00000800  /* C4        ) Synonyms */
140    #define PCRE_UTF32              0x00000800  /* C4        )          */
141    #define PCRE_NO_AUTO_CAPTURE    0x00001000  /* C1       */
142    #define PCRE_NO_UTF8_CHECK      0x00002000  /* C1 E D J  )          */
143    #define PCRE_NO_UTF16_CHECK     0x00002000  /* C1 E D J  ) Synonyms */
144    #define PCRE_NO_UTF32_CHECK     0x00002000  /* C1 E D J  )          */
145    #define PCRE_AUTO_CALLOUT       0x00004000  /* C1       */
146    #define PCRE_PARTIAL_SOFT       0x00008000  /*    E D J  ) Synonyms */
147    #define PCRE_PARTIAL            0x00008000  /*    E D J  )          */
148    
149    /* This pair use the same bit. */
150    #define PCRE_NEVER_UTF          0x00010000  /* C1        ) Overlaid */
151    #define PCRE_DFA_SHORTEST       0x00010000  /*      D    ) Overlaid */
152    
153    #define PCRE_DFA_RESTART        0x00020000  /*      D   */
154    #define PCRE_FIRSTLINE          0x00040000  /* C3       */
155    #define PCRE_DUPNAMES           0x00080000  /* C1       */
156    #define PCRE_NEWLINE_CR         0x00100000  /* C3 E D   */
157    #define PCRE_NEWLINE_LF         0x00200000  /* C3 E D   */
158    #define PCRE_NEWLINE_CRLF       0x00300000  /* C3 E D   */
159    #define PCRE_NEWLINE_ANY        0x00400000  /* C3 E D   */
160    #define PCRE_NEWLINE_ANYCRLF    0x00500000  /* C3 E D   */
161    #define PCRE_BSR_ANYCRLF        0x00800000  /* C3 E D   */
162    #define PCRE_BSR_UNICODE        0x01000000  /* C3 E D   */
163    #define PCRE_JAVASCRIPT_COMPAT  0x02000000  /* C5       */
164    #define PCRE_NO_START_OPTIMIZE  0x04000000  /* C2 E D    ) Synonyms */
165    #define PCRE_NO_START_OPTIMISE  0x04000000  /* C2 E D    )          */
166    #define PCRE_PARTIAL_HARD       0x08000000  /*    E D J */
167    #define PCRE_NOTEMPTY_ATSTART   0x10000000  /*    E D J */
168    #define PCRE_UCP                0x20000000  /* C3       */
169    
170  /* Exec-time and get/set-time error codes */  /* Exec-time and get/set-time error codes */
171    
172  #define PCRE_ERROR_NOMATCH         (-1)  #define PCRE_ERROR_NOMATCH          (-1)
173  #define PCRE_ERROR_NULL            (-2)  #define PCRE_ERROR_NULL             (-2)
174  #define PCRE_ERROR_BADOPTION       (-3)  #define PCRE_ERROR_BADOPTION        (-3)
175  #define PCRE_ERROR_BADMAGIC        (-4)  #define PCRE_ERROR_BADMAGIC         (-4)
176  #define PCRE_ERROR_UNKNOWN_OPCODE  (-5)  #define PCRE_ERROR_UNKNOWN_OPCODE   (-5)
177  #define PCRE_ERROR_UNKNOWN_NODE    (-5)  /* For backward compatibility */  #define PCRE_ERROR_UNKNOWN_NODE     (-5)  /* For backward compatibility */
178  #define PCRE_ERROR_NOMEMORY        (-6)  #define PCRE_ERROR_NOMEMORY         (-6)
179  #define PCRE_ERROR_NOSUBSTRING     (-7)  #define PCRE_ERROR_NOSUBSTRING      (-7)
180  #define PCRE_ERROR_MATCHLIMIT      (-8)  #define PCRE_ERROR_MATCHLIMIT       (-8)
181  #define PCRE_ERROR_CALLOUT         (-9)  /* Never used by PCRE itself */  #define PCRE_ERROR_CALLOUT          (-9)  /* Never used by PCRE itself */
182  #define PCRE_ERROR_BADUTF8        (-10)  #define PCRE_ERROR_BADUTF8         (-10)  /* Same for 8/16/32 */
183  #define PCRE_ERROR_BADUTF8_OFFSET (-11)  #define PCRE_ERROR_BADUTF16        (-10)  /* Same for 8/16/32 */
184  #define PCRE_ERROR_PARTIAL        (-12)  #define PCRE_ERROR_BADUTF32        (-10)  /* Same for 8/16/32 */
185  #define PCRE_ERROR_BADPARTIAL     (-13)  #define PCRE_ERROR_BADUTF8_OFFSET  (-11)  /* Same for 8/16 */
186  #define PCRE_ERROR_INTERNAL       (-14)  #define PCRE_ERROR_BADUTF16_OFFSET (-11)  /* Same for 8/16 */
187  #define PCRE_ERROR_BADCOUNT       (-15)  #define PCRE_ERROR_PARTIAL         (-12)
188  #define PCRE_ERROR_DFA_UITEM      (-16)  #define PCRE_ERROR_BADPARTIAL      (-13)
189  #define PCRE_ERROR_DFA_UCOND      (-17)  #define PCRE_ERROR_INTERNAL        (-14)
190  #define PCRE_ERROR_DFA_UMLIMIT    (-18)  #define PCRE_ERROR_BADCOUNT        (-15)
191  #define PCRE_ERROR_DFA_WSSIZE     (-19)  #define PCRE_ERROR_DFA_UITEM       (-16)
192  #define PCRE_ERROR_DFA_RECURSE    (-20)  #define PCRE_ERROR_DFA_UCOND       (-17)
193  #define PCRE_ERROR_RECURSIONLIMIT (-21)  #define PCRE_ERROR_DFA_UMLIMIT     (-18)
194  #define PCRE_ERROR_NULLWSLIMIT    (-22)  /* No longer actually used */  #define PCRE_ERROR_DFA_WSSIZE      (-19)
195  #define PCRE_ERROR_BADNEWLINE     (-23)  #define PCRE_ERROR_DFA_RECURSE     (-20)
196    #define PCRE_ERROR_RECURSIONLIMIT  (-21)
197    #define PCRE_ERROR_NULLWSLIMIT     (-22)  /* No longer actually used */
198    #define PCRE_ERROR_BADNEWLINE      (-23)
199    #define PCRE_ERROR_BADOFFSET       (-24)
200    #define PCRE_ERROR_SHORTUTF8       (-25)
201    #define PCRE_ERROR_SHORTUTF16      (-25)  /* Same for 8/16 */
202    #define PCRE_ERROR_RECURSELOOP     (-26)
203    #define PCRE_ERROR_JIT_STACKLIMIT  (-27)
204    #define PCRE_ERROR_BADMODE         (-28)
205    #define PCRE_ERROR_BADENDIANNESS   (-29)
206    #define PCRE_ERROR_DFA_BADRESTART  (-30)
207    #define PCRE_ERROR_JIT_BADOPTION   (-31)
208    #define PCRE_ERROR_BADLENGTH       (-32)
209    
210    /* Specific error codes for UTF-8 validity checks */
211    
212    #define PCRE_UTF8_ERR0               0
213    #define PCRE_UTF8_ERR1               1
214    #define PCRE_UTF8_ERR2               2
215    #define PCRE_UTF8_ERR3               3
216    #define PCRE_UTF8_ERR4               4
217    #define PCRE_UTF8_ERR5               5
218    #define PCRE_UTF8_ERR6               6
219    #define PCRE_UTF8_ERR7               7
220    #define PCRE_UTF8_ERR8               8
221    #define PCRE_UTF8_ERR9               9
222    #define PCRE_UTF8_ERR10             10
223    #define PCRE_UTF8_ERR11             11
224    #define PCRE_UTF8_ERR12             12
225    #define PCRE_UTF8_ERR13             13
226    #define PCRE_UTF8_ERR14             14
227    #define PCRE_UTF8_ERR15             15
228    #define PCRE_UTF8_ERR16             16
229    #define PCRE_UTF8_ERR17             17
230    #define PCRE_UTF8_ERR18             18
231    #define PCRE_UTF8_ERR19             19
232    #define PCRE_UTF8_ERR20             20
233    #define PCRE_UTF8_ERR21             21
234    #define PCRE_UTF8_ERR22             22  /* Unused (was non-character) */
235    
236    /* Specific error codes for UTF-16 validity checks */
237    
238    #define PCRE_UTF16_ERR0              0
239    #define PCRE_UTF16_ERR1              1
240    #define PCRE_UTF16_ERR2              2
241    #define PCRE_UTF16_ERR3              3
242    #define PCRE_UTF16_ERR4              4  /* Unused (was non-character) */
243    
244    /* Specific error codes for UTF-32 validity checks */
245    
246    #define PCRE_UTF32_ERR0              0
247    #define PCRE_UTF32_ERR1              1
248    #define PCRE_UTF32_ERR2              2  /* Unused (was non-character) */
249    #define PCRE_UTF32_ERR3              3
250    
251  /* Request types for pcre_fullinfo() */  /* Request types for pcre_fullinfo() */
252    
# Line 181  compile-time only bits for runtime optio Line 267  compile-time only bits for runtime optio
267  #define PCRE_INFO_JCHANGED          13  #define PCRE_INFO_JCHANGED          13
268  #define PCRE_INFO_HASCRORLF         14  #define PCRE_INFO_HASCRORLF         14
269  #define PCRE_INFO_MINLENGTH         15  #define PCRE_INFO_MINLENGTH         15
270    #define PCRE_INFO_JIT               16
271    #define PCRE_INFO_JITSIZE           17
272    #define PCRE_INFO_MAXLOOKBEHIND     18
273    #define PCRE_INFO_FIRSTCHARACTER      19
274    #define PCRE_INFO_FIRSTCHARACTERFLAGS   20
275    #define PCRE_INFO_REQUIREDCHAR      21
276    #define PCRE_INFO_REQUIREDCHARFLAGS   22
277    
278  /* 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
279  compatible. */  compatible. */
# Line 194  compatible. */ Line 287  compatible. */
287  #define PCRE_CONFIG_UNICODE_PROPERTIES      6  #define PCRE_CONFIG_UNICODE_PROPERTIES      6
288  #define PCRE_CONFIG_MATCH_LIMIT_RECURSION   7  #define PCRE_CONFIG_MATCH_LIMIT_RECURSION   7
289  #define PCRE_CONFIG_BSR                     8  #define PCRE_CONFIG_BSR                     8
290    #define PCRE_CONFIG_JIT                     9
291    #define PCRE_CONFIG_UTF16                  10
292    #define PCRE_CONFIG_JITTARGET              11
293    #define PCRE_CONFIG_UTF32                  12
294    
295  /* 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
296    compatible. */
297    
298    #define PCRE_STUDY_JIT_COMPILE                0x0001
299    #define PCRE_STUDY_JIT_PARTIAL_SOFT_COMPILE   0x0002
300    #define PCRE_STUDY_JIT_PARTIAL_HARD_COMPILE   0x0004
301    #define PCRE_STUDY_EXTRA_NEEDED               0x0008
302    
303    /* Bit flags for the pcre[16|32]_extra structure. Do not re-arrange or redefine
304  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. */
305    
306  #define PCRE_EXTRA_STUDY_DATA             0x0001  #define PCRE_EXTRA_STUDY_DATA             0x0001
# Line 204  these bits, just add new ones on the end Line 309  these bits, just add new ones on the end
309  #define PCRE_EXTRA_TABLES                 0x0008  #define PCRE_EXTRA_TABLES                 0x0008
310  #define PCRE_EXTRA_MATCH_LIMIT_RECURSION  0x0010  #define PCRE_EXTRA_MATCH_LIMIT_RECURSION  0x0010
311  #define PCRE_EXTRA_MARK                   0x0020  #define PCRE_EXTRA_MARK                   0x0020
312    #define PCRE_EXTRA_EXECUTABLE_JIT         0x0040
313    
314  /* Types */  /* Types */
315    
316  struct real_pcre;                 /* declaration; the definition is private  */  struct real_pcre;                 /* declaration; the definition is private  */
317  typedef struct real_pcre pcre;  typedef struct real_pcre pcre;
318    
319    struct real_pcre16;               /* declaration; the definition is private  */
320    typedef struct real_pcre16 pcre16;
321    
322    struct real_pcre32;               /* declaration; the definition is private  */
323    typedef struct real_pcre32 pcre32;
324    
325    struct real_pcre_jit_stack;       /* declaration; the definition is private  */
326    typedef struct real_pcre_jit_stack pcre_jit_stack;
327    
328    struct real_pcre16_jit_stack;     /* declaration; the definition is private  */
329    typedef struct real_pcre16_jit_stack pcre16_jit_stack;
330    
331    struct real_pcre32_jit_stack;     /* declaration; the definition is private  */
332    typedef struct real_pcre32_jit_stack pcre32_jit_stack;
333    
334    /* If PCRE is compiled with 16 bit character support, PCRE_UCHAR16 must contain
335    a 16 bit wide signed data type. Otherwise it can be a dummy data type since
336    pcre16 functions are not implemented. There is a check for this in pcre_internal.h. */
337    #ifndef PCRE_UCHAR16
338    #define PCRE_UCHAR16 unsigned short
339    #endif
340    
341    #ifndef PCRE_SPTR16
342    #define PCRE_SPTR16 const PCRE_UCHAR16 *
343    #endif
344    
345    /* If PCRE is compiled with 32 bit character support, PCRE_UCHAR32 must contain
346    a 32 bit wide signed data type. Otherwise it can be a dummy data type since
347    pcre32 functions are not implemented. There is a check for this in pcre_internal.h. */
348    #ifndef PCRE_UCHAR32
349    #define PCRE_UCHAR32 unsigned int
350    #endif
351    
352    #ifndef PCRE_SPTR32
353    #define PCRE_SPTR32 const PCRE_UCHAR32 *
354    #endif
355    
356  /* 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
357  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
358  const char *. */  const char *. */
# Line 230  typedef struct pcre_extra { Line 373  typedef struct pcre_extra {
373    const unsigned char *tables;    /* Pointer to character tables */    const unsigned char *tables;    /* Pointer to character tables */
374    unsigned long int match_limit_recursion; /* Max recursive calls to match() */    unsigned long int match_limit_recursion; /* Max recursive calls to match() */
375    unsigned char **mark;           /* For passing back a mark pointer */    unsigned char **mark;           /* For passing back a mark pointer */
376      void *executable_jit;           /* Contains a pointer to a compiled jit code */
377  } pcre_extra;  } pcre_extra;
378    
379    /* Same structure as above, but with 16 bit char pointers. */
380    
381    typedef struct pcre16_extra {
382      unsigned long int flags;        /* Bits for which fields are set */
383      void *study_data;               /* Opaque data from pcre_study() */
384      unsigned long int match_limit;  /* Maximum number of calls to match() */
385      void *callout_data;             /* Data passed back in callouts */
386      const unsigned char *tables;    /* Pointer to character tables */
387      unsigned long int match_limit_recursion; /* Max recursive calls to match() */
388      PCRE_UCHAR16 **mark;            /* For passing back a mark pointer */
389      void *executable_jit;           /* Contains a pointer to a compiled jit code */
390    } pcre16_extra;
391    
392    /* Same structure as above, but with 32 bit char pointers. */
393    
394    typedef struct pcre32_extra {
395      unsigned long int flags;        /* Bits for which fields are set */
396      void *study_data;               /* Opaque data from pcre_study() */
397      unsigned long int match_limit;  /* Maximum number of calls to match() */
398      void *callout_data;             /* Data passed back in callouts */
399      const unsigned char *tables;    /* Pointer to character tables */
400      unsigned long int match_limit_recursion; /* Max recursive calls to match() */
401      PCRE_UCHAR32 **mark;            /* For passing back a mark pointer */
402      void *executable_jit;           /* Contains a pointer to a compiled jit code */
403    } pcre32_extra;
404    
405  /* 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
406  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,
407  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 252  typedef struct pcre_callout_block { Line 422  typedef struct pcre_callout_block {
422    /* ------------------- Added for Version 1 -------------------------- */    /* ------------------- Added for Version 1 -------------------------- */
423    int          pattern_position;  /* Offset to next item in the pattern */    int          pattern_position;  /* Offset to next item in the pattern */
424    int          next_item_length;  /* Length of next item in the pattern */    int          next_item_length;  /* Length of next item in the pattern */
425      /* ------------------- Added for Version 2 -------------------------- */
426      const unsigned char *mark;      /* Pointer to current mark or NULL    */
427    /* ------------------------------------------------------------------ */    /* ------------------------------------------------------------------ */
428  } pcre_callout_block;  } pcre_callout_block;
429    
430    /* Same structure as above, but with 16 bit char pointers. */
431    
432    typedef struct pcre16_callout_block {
433      int          version;           /* Identifies version of block */
434      /* ------------------------ Version 0 ------------------------------- */
435      int          callout_number;    /* Number compiled into pattern */
436      int         *offset_vector;     /* The offset vector */
437      PCRE_SPTR16  subject;           /* The subject being matched */
438      int          subject_length;    /* The length of the subject */
439      int          start_match;       /* Offset to start of this match attempt */
440      int          current_position;  /* Where we currently are in the subject */
441      int          capture_top;       /* Max current capture */
442      int          capture_last;      /* Most recently closed capture */
443      void        *callout_data;      /* Data passed in with the call */
444      /* ------------------- Added for Version 1 -------------------------- */
445      int          pattern_position;  /* Offset to next item in the pattern */
446      int          next_item_length;  /* Length of next item in the pattern */
447      /* ------------------- Added for Version 2 -------------------------- */
448      const PCRE_UCHAR16 *mark;       /* Pointer to current mark or NULL    */
449      /* ------------------------------------------------------------------ */
450    } pcre16_callout_block;
451    
452    /* Same structure as above, but with 32 bit char pointers. */
453    
454    typedef struct pcre32_callout_block {
455      int          version;           /* Identifies version of block */
456      /* ------------------------ Version 0 ------------------------------- */
457      int          callout_number;    /* Number compiled into pattern */
458      int         *offset_vector;     /* The offset vector */
459      PCRE_SPTR32  subject;           /* The subject being matched */
460      int          subject_length;    /* The length of the subject */
461      int          start_match;       /* Offset to start of this match attempt */
462      int          current_position;  /* Where we currently are in the subject */
463      int          capture_top;       /* Max current capture */
464      int          capture_last;      /* Most recently closed capture */
465      void        *callout_data;      /* Data passed in with the call */
466      /* ------------------- Added for Version 1 -------------------------- */
467      int          pattern_position;  /* Offset to next item in the pattern */
468      int          next_item_length;  /* Length of next item in the pattern */
469      /* ------------------- Added for Version 2 -------------------------- */
470      const PCRE_UCHAR32 *mark;       /* Pointer to current mark or NULL    */
471      /* ------------------------------------------------------------------ */
472    } pcre32_callout_block;
473    
474  /* Indirection for store get and free functions. These can be set to  /* Indirection for store get and free functions. These can be set to
475  alternative malloc/free functions if required. Special ones are used in the  alternative malloc/free functions if required. Special ones are used in the
476  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 267  PCRE_EXP_DECL void  (*pcre_free)(void *) Line 483  PCRE_EXP_DECL void  (*pcre_free)(void *)
483  PCRE_EXP_DECL void *(*pcre_stack_malloc)(size_t);  PCRE_EXP_DECL void *(*pcre_stack_malloc)(size_t);
484  PCRE_EXP_DECL void  (*pcre_stack_free)(void *);  PCRE_EXP_DECL void  (*pcre_stack_free)(void *);
485  PCRE_EXP_DECL int   (*pcre_callout)(pcre_callout_block *);  PCRE_EXP_DECL int   (*pcre_callout)(pcre_callout_block *);
486    
487    PCRE_EXP_DECL void *(*pcre16_malloc)(size_t);
488    PCRE_EXP_DECL void  (*pcre16_free)(void *);
489    PCRE_EXP_DECL void *(*pcre16_stack_malloc)(size_t);
490    PCRE_EXP_DECL void  (*pcre16_stack_free)(void *);
491    PCRE_EXP_DECL int   (*pcre16_callout)(pcre16_callout_block *);
492    
493    PCRE_EXP_DECL void *(*pcre32_malloc)(size_t);
494    PCRE_EXP_DECL void  (*pcre32_free)(void *);
495    PCRE_EXP_DECL void *(*pcre32_stack_malloc)(size_t);
496    PCRE_EXP_DECL void  (*pcre32_stack_free)(void *);
497    PCRE_EXP_DECL int   (*pcre32_callout)(pcre32_callout_block *);
498  #else   /* VPCOMPAT */  #else   /* VPCOMPAT */
499  PCRE_EXP_DECL void *pcre_malloc(size_t);  PCRE_EXP_DECL void *pcre_malloc(size_t);
500  PCRE_EXP_DECL void  pcre_free(void *);  PCRE_EXP_DECL void  pcre_free(void *);
501  PCRE_EXP_DECL void *pcre_stack_malloc(size_t);  PCRE_EXP_DECL void *pcre_stack_malloc(size_t);
502  PCRE_EXP_DECL void  pcre_stack_free(void *);  PCRE_EXP_DECL void  pcre_stack_free(void *);
503  PCRE_EXP_DECL int   pcre_callout(pcre_callout_block *);  PCRE_EXP_DECL int   pcre_callout(pcre_callout_block *);
504    
505    PCRE_EXP_DECL void *pcre16_malloc(size_t);
506    PCRE_EXP_DECL void  pcre16_free(void *);
507    PCRE_EXP_DECL void *pcre16_stack_malloc(size_t);
508    PCRE_EXP_DECL void  pcre16_stack_free(void *);
509    PCRE_EXP_DECL int   pcre16_callout(pcre16_callout_block *);
510    
511    PCRE_EXP_DECL void *pcre32_malloc(size_t);
512    PCRE_EXP_DECL void  pcre32_free(void *);
513    PCRE_EXP_DECL void *pcre32_stack_malloc(size_t);
514    PCRE_EXP_DECL void  pcre32_stack_free(void *);
515    PCRE_EXP_DECL int   pcre32_callout(pcre32_callout_block *);
516  #endif  /* VPCOMPAT */  #endif  /* VPCOMPAT */
517    
518    /* User defined callback which provides a stack just before the match starts. */
519    
520    typedef pcre_jit_stack *(*pcre_jit_callback)(void *);
521    typedef pcre16_jit_stack *(*pcre16_jit_callback)(void *);
522    typedef pcre32_jit_stack *(*pcre32_jit_callback)(void *);
523    
524  /* Exported PCRE functions */  /* Exported PCRE functions */
525    
526  PCRE_EXP_DECL pcre *pcre_compile(const char *, int, const char **, int *,  PCRE_EXP_DECL pcre *pcre_compile(const char *, int, const char **, int *,
527                    const unsigned char *);                    const unsigned char *);
528    PCRE_EXP_DECL pcre16 *pcre16_compile(PCRE_SPTR16, int, const char **, int *,
529                      const unsigned char *);
530    PCRE_EXP_DECL pcre32 *pcre32_compile(PCRE_SPTR32, int, const char **, int *,
531                      const unsigned char *);
532  PCRE_EXP_DECL pcre *pcre_compile2(const char *, int, int *, const char **,  PCRE_EXP_DECL pcre *pcre_compile2(const char *, int, int *, const char **,
533                    int *, const unsigned char *);                    int *, const unsigned char *);
534    PCRE_EXP_DECL pcre16 *pcre16_compile2(PCRE_SPTR16, int, int *, const char **,
535                      int *, const unsigned char *);
536    PCRE_EXP_DECL pcre32 *pcre32_compile2(PCRE_SPTR32, int, int *, const char **,
537                      int *, const unsigned char *);
538  PCRE_EXP_DECL int  pcre_config(int, void *);  PCRE_EXP_DECL int  pcre_config(int, void *);
539    PCRE_EXP_DECL int  pcre16_config(int, void *);
540    PCRE_EXP_DECL int  pcre32_config(int, void *);
541  PCRE_EXP_DECL int  pcre_copy_named_substring(const pcre *, const char *,  PCRE_EXP_DECL int  pcre_copy_named_substring(const pcre *, const char *,
542                    int *, int, const char *, char *, int);                    int *, int, const char *, char *, int);
543  PCRE_EXP_DECL int  pcre_copy_substring(const char *, int *, int, int, char *,  PCRE_EXP_DECL int  pcre16_copy_named_substring(const pcre16 *, PCRE_SPTR16,
544                    int);                    int *, int, PCRE_SPTR16, PCRE_UCHAR16 *, int);
545    PCRE_EXP_DECL int  pcre32_copy_named_substring(const pcre32 *, PCRE_SPTR32,
546                      int *, int, PCRE_SPTR32, PCRE_UCHAR32 *, int);
547    PCRE_EXP_DECL int  pcre_copy_substring(const char *, int *, int, int,
548                      char *, int);
549    PCRE_EXP_DECL int  pcre16_copy_substring(PCRE_SPTR16, int *, int, int,
550                      PCRE_UCHAR16 *, int);
551    PCRE_EXP_DECL int  pcre32_copy_substring(PCRE_SPTR32, int *, int, int,
552                      PCRE_UCHAR32 *, int);
553  PCRE_EXP_DECL int  pcre_dfa_exec(const pcre *, const pcre_extra *,  PCRE_EXP_DECL int  pcre_dfa_exec(const pcre *, const pcre_extra *,
554                    const char *, int, int, int, int *, int , int *, int);                    const char *, int, int, int, int *, int , int *, int);
555    PCRE_EXP_DECL int  pcre16_dfa_exec(const pcre16 *, const pcre16_extra *,
556                      PCRE_SPTR16, int, int, int, int *, int , int *, int);
557    PCRE_EXP_DECL int  pcre32_dfa_exec(const pcre32 *, const pcre32_extra *,
558                      PCRE_SPTR32, int, int, int, int *, int , int *, int);
559  PCRE_EXP_DECL int  pcre_exec(const pcre *, const pcre_extra *, PCRE_SPTR,  PCRE_EXP_DECL int  pcre_exec(const pcre *, const pcre_extra *, PCRE_SPTR,
560                     int, int, int, int *, int);                     int, int, int, int *, int);
561    PCRE_EXP_DECL int  pcre16_exec(const pcre16 *, const pcre16_extra *,
562                       PCRE_SPTR16, int, int, int, int *, int);
563    PCRE_EXP_DECL int  pcre32_exec(const pcre32 *, const pcre32_extra *,
564                       PCRE_SPTR32, int, int, int, int *, int);
565    PCRE_EXP_DECL int  pcre_jit_exec(const pcre *, const pcre_extra *,
566                       PCRE_SPTR, int, int, int, int *, int,
567                       pcre_jit_stack *);
568    PCRE_EXP_DECL int  pcre16_jit_exec(const pcre16 *, const pcre16_extra *,
569                       PCRE_SPTR16, int, int, int, int *, int,
570                       pcre16_jit_stack *);
571    PCRE_EXP_DECL int  pcre32_jit_exec(const pcre32 *, const pcre32_extra *,
572                       PCRE_SPTR32, int, int, int, int *, int,
573                       pcre32_jit_stack *);
574  PCRE_EXP_DECL void pcre_free_substring(const char *);  PCRE_EXP_DECL void pcre_free_substring(const char *);
575    PCRE_EXP_DECL void pcre16_free_substring(PCRE_SPTR16);
576    PCRE_EXP_DECL void pcre32_free_substring(PCRE_SPTR32);
577  PCRE_EXP_DECL void pcre_free_substring_list(const char **);  PCRE_EXP_DECL void pcre_free_substring_list(const char **);
578    PCRE_EXP_DECL void pcre16_free_substring_list(PCRE_SPTR16 *);
579    PCRE_EXP_DECL void pcre32_free_substring_list(PCRE_SPTR32 *);
580  PCRE_EXP_DECL int  pcre_fullinfo(const pcre *, const pcre_extra *, int,  PCRE_EXP_DECL int  pcre_fullinfo(const pcre *, const pcre_extra *, int,
581                    void *);                    void *);
582    PCRE_EXP_DECL int  pcre16_fullinfo(const pcre16 *, const pcre16_extra *, int,
583                      void *);
584    PCRE_EXP_DECL int  pcre32_fullinfo(const pcre32 *, const pcre32_extra *, int,
585                      void *);
586  PCRE_EXP_DECL int  pcre_get_named_substring(const pcre *, const char *,  PCRE_EXP_DECL int  pcre_get_named_substring(const pcre *, const char *,
587                    int *, int, const char *, const char **);                    int *, int, const char *, const char **);
588    PCRE_EXP_DECL int  pcre16_get_named_substring(const pcre16 *, PCRE_SPTR16,
589                      int *, int, PCRE_SPTR16, PCRE_SPTR16 *);
590    PCRE_EXP_DECL int  pcre32_get_named_substring(const pcre32 *, PCRE_SPTR32,
591                      int *, int, PCRE_SPTR32, PCRE_SPTR32 *);
592  PCRE_EXP_DECL int  pcre_get_stringnumber(const pcre *, const char *);  PCRE_EXP_DECL int  pcre_get_stringnumber(const pcre *, const char *);
593    PCRE_EXP_DECL int  pcre16_get_stringnumber(const pcre16 *, PCRE_SPTR16);
594    PCRE_EXP_DECL int  pcre32_get_stringnumber(const pcre32 *, PCRE_SPTR32);
595  PCRE_EXP_DECL int  pcre_get_stringtable_entries(const pcre *, const char *,  PCRE_EXP_DECL int  pcre_get_stringtable_entries(const pcre *, const char *,
596                    char **, char **);                    char **, char **);
597    PCRE_EXP_DECL int  pcre16_get_stringtable_entries(const pcre16 *, PCRE_SPTR16,
598                      PCRE_UCHAR16 **, PCRE_UCHAR16 **);
599    PCRE_EXP_DECL int  pcre32_get_stringtable_entries(const pcre32 *, PCRE_SPTR32,
600                      PCRE_UCHAR32 **, PCRE_UCHAR32 **);
601  PCRE_EXP_DECL int  pcre_get_substring(const char *, int *, int, int,  PCRE_EXP_DECL int  pcre_get_substring(const char *, int *, int, int,
602                    const char **);                    const char **);
603    PCRE_EXP_DECL int  pcre16_get_substring(PCRE_SPTR16, int *, int, int,
604                      PCRE_SPTR16 *);
605    PCRE_EXP_DECL int  pcre32_get_substring(PCRE_SPTR32, int *, int, int,
606                      PCRE_SPTR32 *);
607  PCRE_EXP_DECL int  pcre_get_substring_list(const char *, int *, int,  PCRE_EXP_DECL int  pcre_get_substring_list(const char *, int *, int,
608                    const char ***);                    const char ***);
609  PCRE_EXP_DECL int  pcre_info(const pcre *, int *, int *);  PCRE_EXP_DECL int  pcre16_get_substring_list(PCRE_SPTR16, int *, int,
610                      PCRE_SPTR16 **);
611    PCRE_EXP_DECL int  pcre32_get_substring_list(PCRE_SPTR32, int *, int,
612                      PCRE_SPTR32 **);
613  PCRE_EXP_DECL const unsigned char *pcre_maketables(void);  PCRE_EXP_DECL const unsigned char *pcre_maketables(void);
614    PCRE_EXP_DECL const unsigned char *pcre16_maketables(void);
615    PCRE_EXP_DECL const unsigned char *pcre32_maketables(void);
616  PCRE_EXP_DECL int  pcre_refcount(pcre *, int);  PCRE_EXP_DECL int  pcre_refcount(pcre *, int);
617    PCRE_EXP_DECL int  pcre16_refcount(pcre16 *, int);
618    PCRE_EXP_DECL int  pcre32_refcount(pcre32 *, int);
619  PCRE_EXP_DECL pcre_extra *pcre_study(const pcre *, int, const char **);  PCRE_EXP_DECL pcre_extra *pcre_study(const pcre *, int, const char **);
620    PCRE_EXP_DECL pcre16_extra *pcre16_study(const pcre16 *, int, const char **);
621    PCRE_EXP_DECL pcre32_extra *pcre32_study(const pcre32 *, int, const char **);
622    PCRE_EXP_DECL void pcre_free_study(pcre_extra *);
623    PCRE_EXP_DECL void pcre16_free_study(pcre16_extra *);
624    PCRE_EXP_DECL void pcre32_free_study(pcre32_extra *);
625  PCRE_EXP_DECL const char *pcre_version(void);  PCRE_EXP_DECL const char *pcre_version(void);
626    PCRE_EXP_DECL const char *pcre16_version(void);
627    PCRE_EXP_DECL const char *pcre32_version(void);
628    
629    /* Utility functions for byte order swaps. */
630    PCRE_EXP_DECL int  pcre_pattern_to_host_byte_order(pcre *, pcre_extra *,
631                      const unsigned char *);
632    PCRE_EXP_DECL int  pcre16_pattern_to_host_byte_order(pcre16 *, pcre16_extra *,
633                      const unsigned char *);
634    PCRE_EXP_DECL int  pcre32_pattern_to_host_byte_order(pcre32 *, pcre32_extra *,
635                      const unsigned char *);
636    PCRE_EXP_DECL int  pcre16_utf16_to_host_byte_order(PCRE_UCHAR16 *,
637                      PCRE_SPTR16, int, int *, int);
638    PCRE_EXP_DECL int  pcre32_utf32_to_host_byte_order(PCRE_UCHAR32 *,
639                      PCRE_SPTR32, int, int *, int);
640    
641    /* JIT compiler related functions. */
642    
643    PCRE_EXP_DECL pcre_jit_stack *pcre_jit_stack_alloc(int, int);
644    PCRE_EXP_DECL pcre16_jit_stack *pcre16_jit_stack_alloc(int, int);
645    PCRE_EXP_DECL pcre32_jit_stack *pcre32_jit_stack_alloc(int, int);
646    PCRE_EXP_DECL void pcre_jit_stack_free(pcre_jit_stack *);
647    PCRE_EXP_DECL void pcre16_jit_stack_free(pcre16_jit_stack *);
648    PCRE_EXP_DECL void pcre32_jit_stack_free(pcre32_jit_stack *);
649    PCRE_EXP_DECL void pcre_assign_jit_stack(pcre_extra *,
650                      pcre_jit_callback, void *);
651    PCRE_EXP_DECL void pcre16_assign_jit_stack(pcre16_extra *,
652                      pcre16_jit_callback, void *);
653    PCRE_EXP_DECL void pcre32_assign_jit_stack(pcre32_extra *,
654                      pcre32_jit_callback, void *);
655    
656  #ifdef __cplusplus  #ifdef __cplusplus
657  }  /* extern "C" */  }  /* extern "C" */

Legend:
Removed from v.553  
changed lines
  Added in v.1309

  ViewVC Help
Powered by ViewVC 1.1.5