654 lines
		
	
	
		
			30 KiB
		
	
	
	
		
			C
		
	
	
	
	
	
			
		
		
	
	
			654 lines
		
	
	
		
			30 KiB
		
	
	
	
		
			C
		
	
	
	
	
	
/*************************************************
 | 
						|
*       Perl-Compatible Regular Expressions      *
 | 
						|
*************************************************/
 | 
						|
 | 
						|
/* This is the public header file for the PCRE library, to be #included by
 | 
						|
applications that call the PCRE functions.
 | 
						|
 | 
						|
           Copyright (c) 1997-2012 University of Cambridge
 | 
						|
 | 
						|
-----------------------------------------------------------------------------
 | 
						|
Redistribution and use in source and binary forms, with or without
 | 
						|
modification, are permitted provided that the following conditions are met:
 | 
						|
 | 
						|
    * Redistributions of source code must retain the above copyright notice,
 | 
						|
      this list of conditions and the following disclaimer.
 | 
						|
 | 
						|
    * Redistributions in binary form must reproduce the above copyright
 | 
						|
      notice, this list of conditions and the following disclaimer in the
 | 
						|
      documentation and/or other materials provided with the distribution.
 | 
						|
 | 
						|
    * Neither the name of the University of Cambridge nor the names of its
 | 
						|
      contributors may be used to endorse or promote products derived from
 | 
						|
      this software without specific prior written permission.
 | 
						|
 | 
						|
THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
 | 
						|
AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
 | 
						|
IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
 | 
						|
ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE
 | 
						|
LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
 | 
						|
CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
 | 
						|
SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
 | 
						|
INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
 | 
						|
CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
 | 
						|
ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
 | 
						|
POSSIBILITY OF SUCH DAMAGE.
 | 
						|
-----------------------------------------------------------------------------
 | 
						|
*/
 | 
						|
 | 
						|
#ifndef _PCRE_H
 | 
						|
#define _PCRE_H
 | 
						|
 | 
						|
/* The current PCRE version information. */
 | 
						|
 | 
						|
#define PCRE_MAJOR          8
 | 
						|
#define PCRE_MINOR          32
 | 
						|
#define PCRE_PRERELEASE     
 | 
						|
#define PCRE_DATE           2012-11-30
 | 
						|
 | 
						|
/* When an application links to a PCRE DLL in Windows, the symbols that are
 | 
						|
imported have to be identified as such. When building PCRE, the appropriate
 | 
						|
export setting is defined in pcre_internal.h, which includes this file. So we
 | 
						|
don't change existing definitions of PCRE_EXP_DECL and PCRECPP_EXP_DECL. */
 | 
						|
 | 
						|
#if defined(_WIN32) && !defined(PCRE_STATIC)
 | 
						|
#  ifndef PCRE_EXP_DECL
 | 
						|
#    define PCRE_EXP_DECL  extern __declspec(dllimport)
 | 
						|
#  endif
 | 
						|
#  ifdef __cplusplus
 | 
						|
#    ifndef PCRECPP_EXP_DECL
 | 
						|
#      define PCRECPP_EXP_DECL  extern __declspec(dllimport)
 | 
						|
#    endif
 | 
						|
#    ifndef PCRECPP_EXP_DEFN
 | 
						|
#      define PCRECPP_EXP_DEFN  __declspec(dllimport)
 | 
						|
#    endif
 | 
						|
#  endif
 | 
						|
#endif
 | 
						|
 | 
						|
/* By default, we use the standard "extern" declarations. */
 | 
						|
 | 
						|
#ifndef PCRE_EXP_DECL
 | 
						|
#  ifdef __cplusplus
 | 
						|
#    define PCRE_EXP_DECL  extern "C"
 | 
						|
#  else
 | 
						|
#    define PCRE_EXP_DECL  extern
 | 
						|
#  endif
 | 
						|
#endif
 | 
						|
 | 
						|
#ifdef __cplusplus
 | 
						|
#  ifndef PCRECPP_EXP_DECL
 | 
						|
#    define PCRECPP_EXP_DECL  extern
 | 
						|
#  endif
 | 
						|
#  ifndef PCRECPP_EXP_DEFN
 | 
						|
#    define PCRECPP_EXP_DEFN
 | 
						|
#  endif
 | 
						|
#endif
 | 
						|
 | 
						|
/* Have to include stdlib.h in order to ensure that size_t is defined;
 | 
						|
it is needed here for malloc. */
 | 
						|
 | 
						|
#include <stdlib.h>
 | 
						|
 | 
						|
/* Allow for C++ users */
 | 
						|
 | 
						|
#ifdef __cplusplus
 | 
						|
extern "C" {
 | 
						|
#endif
 | 
						|
 | 
						|
/* Public options. Some are compile-time only, some are run-time only, and some
 | 
						|
are both, so we keep them all distinct. However, almost all the bits in the
 | 
						|
options word are now used. In the long run, we may have to re-use some of the
 | 
						|
compile-time only bits for runtime options, or vice versa. Any of the
 | 
						|
compile-time options may be inspected during studying (and therefore JIT
 | 
						|
compiling).
 | 
						|
 | 
						|
Some options for pcre_compile() change its behaviour but do not affect the
 | 
						|
behaviour of the execution functions. Other options are passed through to the
 | 
						|
execution functions and affect their behaviour, with or without affecting the
 | 
						|
behaviour of pcre_compile().
 | 
						|
 | 
						|
Options that can be passed to pcre_compile() are tagged Cx below, with these
 | 
						|
variants:
 | 
						|
 | 
						|
C1   Affects compile only
 | 
						|
C2   Does not affect compile; affects exec, dfa_exec
 | 
						|
C3   Affects compile, exec, dfa_exec
 | 
						|
C4   Affects compile, exec, dfa_exec, study
 | 
						|
C5   Affects compile, exec, study
 | 
						|
 | 
						|
Options that can be set for pcre_exec() and/or pcre_dfa_exec() are flagged with
 | 
						|
E and D, respectively. They take precedence over C3, C4, and C5 settings passed
 | 
						|
from pcre_compile(). Those that are compatible with JIT execution are flagged
 | 
						|
with J. */
 | 
						|
 | 
						|
#define PCRE_CASELESS           0x00000001  /* C1       */
 | 
						|
#define PCRE_MULTILINE          0x00000002  /* C1       */
 | 
						|
#define PCRE_DOTALL             0x00000004  /* C1       */
 | 
						|
#define PCRE_EXTENDED           0x00000008  /* C1       */
 | 
						|
#define PCRE_ANCHORED           0x00000010  /* C4 E D   */
 | 
						|
#define PCRE_DOLLAR_ENDONLY     0x00000020  /* C2       */
 | 
						|
#define PCRE_EXTRA              0x00000040  /* C1       */
 | 
						|
#define PCRE_NOTBOL             0x00000080  /*    E D J */
 | 
						|
#define PCRE_NOTEOL             0x00000100  /*    E D J */
 | 
						|
#define PCRE_UNGREEDY           0x00000200  /* C1       */
 | 
						|
#define PCRE_NOTEMPTY           0x00000400  /*    E D J */
 | 
						|
#define PCRE_UTF8               0x00000800  /* C4        )          */
 | 
						|
#define PCRE_UTF16              0x00000800  /* C4        ) Synonyms */
 | 
						|
#define PCRE_UTF32              0x00000800  /* C4        )          */
 | 
						|
#define PCRE_NO_AUTO_CAPTURE    0x00001000  /* C1       */
 | 
						|
#define PCRE_NO_UTF8_CHECK      0x00002000  /* C1 E D J  )          */
 | 
						|
#define PCRE_NO_UTF16_CHECK     0x00002000  /* C1 E D J  ) Synonyms */
 | 
						|
#define PCRE_NO_UTF32_CHECK     0x00002000  /* C1 E D J  )          */
 | 
						|
#define PCRE_AUTO_CALLOUT       0x00004000  /* C1       */
 | 
						|
#define PCRE_PARTIAL_SOFT       0x00008000  /*    E D J  ) Synonyms */
 | 
						|
#define PCRE_PARTIAL            0x00008000  /*    E D J  )          */
 | 
						|
#define PCRE_DFA_SHORTEST       0x00010000  /*      D   */
 | 
						|
#define PCRE_DFA_RESTART        0x00020000  /*      D   */
 | 
						|
#define PCRE_FIRSTLINE          0x00040000  /* C3       */
 | 
						|
#define PCRE_DUPNAMES           0x00080000  /* C1       */
 | 
						|
#define PCRE_NEWLINE_CR         0x00100000  /* C3 E D   */
 | 
						|
#define PCRE_NEWLINE_LF         0x00200000  /* C3 E D   */
 | 
						|
#define PCRE_NEWLINE_CRLF       0x00300000  /* C3 E D   */
 | 
						|
#define PCRE_NEWLINE_ANY        0x00400000  /* C3 E D   */
 | 
						|
#define PCRE_NEWLINE_ANYCRLF    0x00500000  /* C3 E D   */
 | 
						|
#define PCRE_BSR_ANYCRLF        0x00800000  /* C3 E D   */
 | 
						|
#define PCRE_BSR_UNICODE        0x01000000  /* C3 E D   */
 | 
						|
#define PCRE_JAVASCRIPT_COMPAT  0x02000000  /* C5       */
 | 
						|
#define PCRE_NO_START_OPTIMIZE  0x04000000  /* C2 E D    ) Synonyms */
 | 
						|
#define PCRE_NO_START_OPTIMISE  0x04000000  /* C2 E D    )          */
 | 
						|
#define PCRE_PARTIAL_HARD       0x08000000  /*    E D J */
 | 
						|
#define PCRE_NOTEMPTY_ATSTART   0x10000000  /*    E D J */
 | 
						|
#define PCRE_UCP                0x20000000  /* C3       */
 | 
						|
 | 
						|
/* Exec-time and get/set-time error codes */
 | 
						|
 | 
						|
#define PCRE_ERROR_NOMATCH          (-1)
 | 
						|
#define PCRE_ERROR_NULL             (-2)
 | 
						|
#define PCRE_ERROR_BADOPTION        (-3)
 | 
						|
#define PCRE_ERROR_BADMAGIC         (-4)
 | 
						|
#define PCRE_ERROR_UNKNOWN_OPCODE   (-5)
 | 
						|
#define PCRE_ERROR_UNKNOWN_NODE     (-5)  /* For backward compatibility */
 | 
						|
#define PCRE_ERROR_NOMEMORY         (-6)
 | 
						|
#define PCRE_ERROR_NOSUBSTRING      (-7)
 | 
						|
#define PCRE_ERROR_MATCHLIMIT       (-8)
 | 
						|
#define PCRE_ERROR_CALLOUT          (-9)  /* Never used by PCRE itself */
 | 
						|
#define PCRE_ERROR_BADUTF8         (-10)  /* Same for 8/16/32 */
 | 
						|
#define PCRE_ERROR_BADUTF16        (-10)  /* Same for 8/16/32 */
 | 
						|
#define PCRE_ERROR_BADUTF32        (-10)  /* Same for 8/16/32 */
 | 
						|
#define PCRE_ERROR_BADUTF8_OFFSET  (-11)  /* Same for 8/16 */
 | 
						|
#define PCRE_ERROR_BADUTF16_OFFSET (-11)  /* Same for 8/16 */
 | 
						|
#define PCRE_ERROR_PARTIAL         (-12)
 | 
						|
#define PCRE_ERROR_BADPARTIAL      (-13)
 | 
						|
#define PCRE_ERROR_INTERNAL        (-14)
 | 
						|
#define PCRE_ERROR_BADCOUNT        (-15)
 | 
						|
#define PCRE_ERROR_DFA_UITEM       (-16)
 | 
						|
#define PCRE_ERROR_DFA_UCOND       (-17)
 | 
						|
#define PCRE_ERROR_DFA_UMLIMIT     (-18)
 | 
						|
#define PCRE_ERROR_DFA_WSSIZE      (-19)
 | 
						|
#define PCRE_ERROR_DFA_RECURSE     (-20)
 | 
						|
#define PCRE_ERROR_RECURSIONLIMIT  (-21)
 | 
						|
#define PCRE_ERROR_NULLWSLIMIT     (-22)  /* No longer actually used */
 | 
						|
#define PCRE_ERROR_BADNEWLINE      (-23)
 | 
						|
#define PCRE_ERROR_BADOFFSET       (-24)
 | 
						|
#define PCRE_ERROR_SHORTUTF8       (-25)
 | 
						|
#define PCRE_ERROR_SHORTUTF16      (-25)  /* Same for 8/16 */
 | 
						|
#define PCRE_ERROR_RECURSELOOP     (-26)
 | 
						|
#define PCRE_ERROR_JIT_STACKLIMIT  (-27)
 | 
						|
#define PCRE_ERROR_BADMODE         (-28)
 | 
						|
#define PCRE_ERROR_BADENDIANNESS   (-29)
 | 
						|
#define PCRE_ERROR_DFA_BADRESTART  (-30)
 | 
						|
#define PCRE_ERROR_JIT_BADOPTION   (-31)
 | 
						|
#define PCRE_ERROR_BADLENGTH       (-32)
 | 
						|
 | 
						|
/* Specific error codes for UTF-8 validity checks */
 | 
						|
 | 
						|
#define PCRE_UTF8_ERR0               0
 | 
						|
#define PCRE_UTF8_ERR1               1
 | 
						|
#define PCRE_UTF8_ERR2               2
 | 
						|
#define PCRE_UTF8_ERR3               3
 | 
						|
#define PCRE_UTF8_ERR4               4
 | 
						|
#define PCRE_UTF8_ERR5               5
 | 
						|
#define PCRE_UTF8_ERR6               6
 | 
						|
#define PCRE_UTF8_ERR7               7
 | 
						|
#define PCRE_UTF8_ERR8               8
 | 
						|
#define PCRE_UTF8_ERR9               9
 | 
						|
#define PCRE_UTF8_ERR10             10
 | 
						|
#define PCRE_UTF8_ERR11             11
 | 
						|
#define PCRE_UTF8_ERR12             12
 | 
						|
#define PCRE_UTF8_ERR13             13
 | 
						|
#define PCRE_UTF8_ERR14             14
 | 
						|
#define PCRE_UTF8_ERR15             15
 | 
						|
#define PCRE_UTF8_ERR16             16
 | 
						|
#define PCRE_UTF8_ERR17             17
 | 
						|
#define PCRE_UTF8_ERR18             18
 | 
						|
#define PCRE_UTF8_ERR19             19
 | 
						|
#define PCRE_UTF8_ERR20             20
 | 
						|
#define PCRE_UTF8_ERR21             21
 | 
						|
#define PCRE_UTF8_ERR22             22
 | 
						|
 | 
						|
/* Specific error codes for UTF-16 validity checks */
 | 
						|
 | 
						|
#define PCRE_UTF16_ERR0              0
 | 
						|
#define PCRE_UTF16_ERR1              1
 | 
						|
#define PCRE_UTF16_ERR2              2
 | 
						|
#define PCRE_UTF16_ERR3              3
 | 
						|
#define PCRE_UTF16_ERR4              4
 | 
						|
 | 
						|
/* Specific error codes for UTF-32 validity checks */
 | 
						|
 | 
						|
#define PCRE_UTF32_ERR0              0
 | 
						|
#define PCRE_UTF32_ERR1              1
 | 
						|
#define PCRE_UTF32_ERR2              2
 | 
						|
#define PCRE_UTF32_ERR3              3
 | 
						|
 | 
						|
/* Request types for pcre_fullinfo() */
 | 
						|
 | 
						|
#define PCRE_INFO_OPTIONS            0
 | 
						|
#define PCRE_INFO_SIZE               1
 | 
						|
#define PCRE_INFO_CAPTURECOUNT       2
 | 
						|
#define PCRE_INFO_BACKREFMAX         3
 | 
						|
#define PCRE_INFO_FIRSTBYTE          4
 | 
						|
#define PCRE_INFO_FIRSTCHAR          4  /* For backwards compatibility */
 | 
						|
#define PCRE_INFO_FIRSTTABLE         5
 | 
						|
#define PCRE_INFO_LASTLITERAL        6
 | 
						|
#define PCRE_INFO_NAMEENTRYSIZE      7
 | 
						|
#define PCRE_INFO_NAMECOUNT          8
 | 
						|
#define PCRE_INFO_NAMETABLE          9
 | 
						|
#define PCRE_INFO_STUDYSIZE         10
 | 
						|
#define PCRE_INFO_DEFAULT_TABLES    11
 | 
						|
#define PCRE_INFO_OKPARTIAL         12
 | 
						|
#define PCRE_INFO_JCHANGED          13
 | 
						|
#define PCRE_INFO_HASCRORLF         14
 | 
						|
#define PCRE_INFO_MINLENGTH         15
 | 
						|
#define PCRE_INFO_JIT               16
 | 
						|
#define PCRE_INFO_JITSIZE           17
 | 
						|
#define PCRE_INFO_MAXLOOKBEHIND     18
 | 
						|
#define PCRE_INFO_FIRSTCHARACTER      19
 | 
						|
#define PCRE_INFO_FIRSTCHARACTERFLAGS   20
 | 
						|
#define PCRE_INFO_REQUIREDCHAR      21
 | 
						|
#define PCRE_INFO_REQUIREDCHARFLAGS   22
 | 
						|
 | 
						|
/* Request types for pcre_config(). Do not re-arrange, in order to remain
 | 
						|
compatible. */
 | 
						|
 | 
						|
#define PCRE_CONFIG_UTF8                    0
 | 
						|
#define PCRE_CONFIG_NEWLINE                 1
 | 
						|
#define PCRE_CONFIG_LINK_SIZE               2
 | 
						|
#define PCRE_CONFIG_POSIX_MALLOC_THRESHOLD  3
 | 
						|
#define PCRE_CONFIG_MATCH_LIMIT             4
 | 
						|
#define PCRE_CONFIG_STACKRECURSE            5
 | 
						|
#define PCRE_CONFIG_UNICODE_PROPERTIES      6
 | 
						|
#define PCRE_CONFIG_MATCH_LIMIT_RECURSION   7
 | 
						|
#define PCRE_CONFIG_BSR                     8
 | 
						|
#define PCRE_CONFIG_JIT                     9
 | 
						|
#define PCRE_CONFIG_UTF16                  10
 | 
						|
#define PCRE_CONFIG_JITTARGET              11
 | 
						|
#define PCRE_CONFIG_UTF32                  12
 | 
						|
 | 
						|
/* Request types for pcre_study(). Do not re-arrange, in order to remain
 | 
						|
compatible. */
 | 
						|
 | 
						|
#define PCRE_STUDY_JIT_COMPILE                0x0001
 | 
						|
#define PCRE_STUDY_JIT_PARTIAL_SOFT_COMPILE   0x0002
 | 
						|
#define PCRE_STUDY_JIT_PARTIAL_HARD_COMPILE   0x0004
 | 
						|
#define PCRE_STUDY_EXTRA_NEEDED               0x0008
 | 
						|
 | 
						|
/* Bit flags for the pcre[16|32]_extra structure. Do not re-arrange or redefine
 | 
						|
these bits, just add new ones on the end, in order to remain compatible. */
 | 
						|
 | 
						|
#define PCRE_EXTRA_STUDY_DATA             0x0001
 | 
						|
#define PCRE_EXTRA_MATCH_LIMIT            0x0002
 | 
						|
#define PCRE_EXTRA_CALLOUT_DATA           0x0004
 | 
						|
#define PCRE_EXTRA_TABLES                 0x0008
 | 
						|
#define PCRE_EXTRA_MATCH_LIMIT_RECURSION  0x0010
 | 
						|
#define PCRE_EXTRA_MARK                   0x0020
 | 
						|
#define PCRE_EXTRA_EXECUTABLE_JIT         0x0040
 | 
						|
 | 
						|
/* Types */
 | 
						|
 | 
						|
struct real_pcre;                 /* declaration; the definition is private  */
 | 
						|
typedef struct real_pcre pcre;
 | 
						|
 | 
						|
struct real_pcre16;               /* declaration; the definition is private  */
 | 
						|
typedef struct real_pcre16 pcre16;
 | 
						|
 | 
						|
struct real_pcre32;               /* declaration; the definition is private  */
 | 
						|
typedef struct real_pcre32 pcre32;
 | 
						|
 | 
						|
struct real_pcre_jit_stack;       /* declaration; the definition is private  */
 | 
						|
typedef struct real_pcre_jit_stack pcre_jit_stack;
 | 
						|
 | 
						|
struct real_pcre16_jit_stack;     /* declaration; the definition is private  */
 | 
						|
typedef struct real_pcre16_jit_stack pcre16_jit_stack;
 | 
						|
 | 
						|
struct real_pcre32_jit_stack;     /* declaration; the definition is private  */
 | 
						|
typedef struct real_pcre32_jit_stack pcre32_jit_stack;
 | 
						|
 | 
						|
/* If PCRE is compiled with 16 bit character support, PCRE_UCHAR16 must contain
 | 
						|
a 16 bit wide signed data type. Otherwise it can be a dummy data type since
 | 
						|
pcre16 functions are not implemented. There is a check for this in pcre_internal.h. */
 | 
						|
#ifndef PCRE_UCHAR16
 | 
						|
#define PCRE_UCHAR16 unsigned short
 | 
						|
#endif
 | 
						|
 | 
						|
#ifndef PCRE_SPTR16
 | 
						|
#define PCRE_SPTR16 const PCRE_UCHAR16 *
 | 
						|
#endif
 | 
						|
 | 
						|
/* If PCRE is compiled with 32 bit character support, PCRE_UCHAR32 must contain
 | 
						|
a 32 bit wide signed data type. Otherwise it can be a dummy data type since
 | 
						|
pcre32 functions are not implemented. There is a check for this in pcre_internal.h. */
 | 
						|
#ifndef PCRE_UCHAR32
 | 
						|
#define PCRE_UCHAR32 unsigned int
 | 
						|
#endif
 | 
						|
 | 
						|
#ifndef PCRE_SPTR32
 | 
						|
#define PCRE_SPTR32 const PCRE_UCHAR32 *
 | 
						|
#endif
 | 
						|
 | 
						|
/* When PCRE is compiled as a C++ library, the subject pointer type can be
 | 
						|
replaced with a custom type. For conventional use, the public interface is a
 | 
						|
const char *. */
 | 
						|
 | 
						|
#ifndef PCRE_SPTR
 | 
						|
#define PCRE_SPTR const char *
 | 
						|
#endif
 | 
						|
 | 
						|
/* The structure for passing additional data to pcre_exec(). This is defined in
 | 
						|
such as way as to be extensible. Always add new fields at the end, in order to
 | 
						|
remain compatible. */
 | 
						|
 | 
						|
typedef struct pcre_extra {
 | 
						|
  unsigned long int flags;        /* Bits for which fields are set */
 | 
						|
  void *study_data;               /* Opaque data from pcre_study() */
 | 
						|
  unsigned long int match_limit;  /* Maximum number of calls to match() */
 | 
						|
  void *callout_data;             /* Data passed back in callouts */
 | 
						|
  const unsigned char *tables;    /* Pointer to character tables */
 | 
						|
  unsigned long int match_limit_recursion; /* Max recursive calls to match() */
 | 
						|
  unsigned char **mark;           /* For passing back a mark pointer */
 | 
						|
  void *executable_jit;           /* Contains a pointer to a compiled jit code */
 | 
						|
} pcre_extra;
 | 
						|
 | 
						|
/* Same structure as above, but with 16 bit char pointers. */
 | 
						|
 | 
						|
typedef struct pcre16_extra {
 | 
						|
  unsigned long int flags;        /* Bits for which fields are set */
 | 
						|
  void *study_data;               /* Opaque data from pcre_study() */
 | 
						|
  unsigned long int match_limit;  /* Maximum number of calls to match() */
 | 
						|
  void *callout_data;             /* Data passed back in callouts */
 | 
						|
  const unsigned char *tables;    /* Pointer to character tables */
 | 
						|
  unsigned long int match_limit_recursion; /* Max recursive calls to match() */
 | 
						|
  PCRE_UCHAR16 **mark;            /* For passing back a mark pointer */
 | 
						|
  void *executable_jit;           /* Contains a pointer to a compiled jit code */
 | 
						|
} pcre16_extra;
 | 
						|
 | 
						|
/* Same structure as above, but with 32 bit char pointers. */
 | 
						|
 | 
						|
typedef struct pcre32_extra {
 | 
						|
  unsigned long int flags;        /* Bits for which fields are set */
 | 
						|
  void *study_data;               /* Opaque data from pcre_study() */
 | 
						|
  unsigned long int match_limit;  /* Maximum number of calls to match() */
 | 
						|
  void *callout_data;             /* Data passed back in callouts */
 | 
						|
  const unsigned char *tables;    /* Pointer to character tables */
 | 
						|
  unsigned long int match_limit_recursion; /* Max recursive calls to match() */
 | 
						|
  PCRE_UCHAR32 **mark;            /* For passing back a mark pointer */
 | 
						|
  void *executable_jit;           /* Contains a pointer to a compiled jit code */
 | 
						|
} pcre32_extra;
 | 
						|
 | 
						|
/* The structure for passing out data via the pcre_callout_function. We use a
 | 
						|
structure so that new fields can be added on the end in future versions,
 | 
						|
without changing the API of the function, thereby allowing old clients to work
 | 
						|
without modification. */
 | 
						|
 | 
						|
typedef struct pcre_callout_block {
 | 
						|
  int          version;           /* Identifies version of block */
 | 
						|
  /* ------------------------ Version 0 ------------------------------- */
 | 
						|
  int          callout_number;    /* Number compiled into pattern */
 | 
						|
  int         *offset_vector;     /* The offset vector */
 | 
						|
  PCRE_SPTR    subject;           /* The subject being matched */
 | 
						|
  int          subject_length;    /* The length of the subject */
 | 
						|
  int          start_match;       /* Offset to start of this match attempt */
 | 
						|
  int          current_position;  /* Where we currently are in the subject */
 | 
						|
  int          capture_top;       /* Max current capture */
 | 
						|
  int          capture_last;      /* Most recently closed capture */
 | 
						|
  void        *callout_data;      /* Data passed in with the call */
 | 
						|
  /* ------------------- Added for Version 1 -------------------------- */
 | 
						|
  int          pattern_position;  /* Offset to next item in the pattern */
 | 
						|
  int          next_item_length;  /* Length of next item in the pattern */
 | 
						|
  /* ------------------- Added for Version 2 -------------------------- */
 | 
						|
  const unsigned char *mark;      /* Pointer to current mark or NULL    */
 | 
						|
  /* ------------------------------------------------------------------ */
 | 
						|
} pcre_callout_block;
 | 
						|
 | 
						|
/* Same structure as above, but with 16 bit char pointers. */
 | 
						|
 | 
						|
typedef struct pcre16_callout_block {
 | 
						|
  int          version;           /* Identifies version of block */
 | 
						|
  /* ------------------------ Version 0 ------------------------------- */
 | 
						|
  int          callout_number;    /* Number compiled into pattern */
 | 
						|
  int         *offset_vector;     /* The offset vector */
 | 
						|
  PCRE_SPTR16  subject;           /* The subject being matched */
 | 
						|
  int          subject_length;    /* The length of the subject */
 | 
						|
  int          start_match;       /* Offset to start of this match attempt */
 | 
						|
  int          current_position;  /* Where we currently are in the subject */
 | 
						|
  int          capture_top;       /* Max current capture */
 | 
						|
  int          capture_last;      /* Most recently closed capture */
 | 
						|
  void        *callout_data;      /* Data passed in with the call */
 | 
						|
  /* ------------------- Added for Version 1 -------------------------- */
 | 
						|
  int          pattern_position;  /* Offset to next item in the pattern */
 | 
						|
  int          next_item_length;  /* Length of next item in the pattern */
 | 
						|
  /* ------------------- Added for Version 2 -------------------------- */
 | 
						|
  const PCRE_UCHAR16 *mark;       /* Pointer to current mark or NULL    */
 | 
						|
  /* ------------------------------------------------------------------ */
 | 
						|
} pcre16_callout_block;
 | 
						|
 | 
						|
/* Same structure as above, but with 32 bit char pointers. */
 | 
						|
 | 
						|
typedef struct pcre32_callout_block {
 | 
						|
  int          version;           /* Identifies version of block */
 | 
						|
  /* ------------------------ Version 0 ------------------------------- */
 | 
						|
  int          callout_number;    /* Number compiled into pattern */
 | 
						|
  int         *offset_vector;     /* The offset vector */
 | 
						|
  PCRE_SPTR32  subject;           /* The subject being matched */
 | 
						|
  int          subject_length;    /* The length of the subject */
 | 
						|
  int          start_match;       /* Offset to start of this match attempt */
 | 
						|
  int          current_position;  /* Where we currently are in the subject */
 | 
						|
  int          capture_top;       /* Max current capture */
 | 
						|
  int          capture_last;      /* Most recently closed capture */
 | 
						|
  void        *callout_data;      /* Data passed in with the call */
 | 
						|
  /* ------------------- Added for Version 1 -------------------------- */
 | 
						|
  int          pattern_position;  /* Offset to next item in the pattern */
 | 
						|
  int          next_item_length;  /* Length of next item in the pattern */
 | 
						|
  /* ------------------- Added for Version 2 -------------------------- */
 | 
						|
  const PCRE_UCHAR32 *mark;       /* Pointer to current mark or NULL    */
 | 
						|
  /* ------------------------------------------------------------------ */
 | 
						|
} pcre32_callout_block;
 | 
						|
 | 
						|
/* Indirection for store get and free functions. These can be set to
 | 
						|
alternative malloc/free functions if required. Special ones are used in the
 | 
						|
non-recursive case for "frames". There is also an optional callout function
 | 
						|
that is triggered by the (?) regex item. For Virtual Pascal, these definitions
 | 
						|
have to take another form. */
 | 
						|
 | 
						|
#ifndef VPCOMPAT
 | 
						|
PCRE_EXP_DECL void *(*pcre_malloc)(size_t);
 | 
						|
PCRE_EXP_DECL void  (*pcre_free)(void *);
 | 
						|
PCRE_EXP_DECL void *(*pcre_stack_malloc)(size_t);
 | 
						|
PCRE_EXP_DECL void  (*pcre_stack_free)(void *);
 | 
						|
PCRE_EXP_DECL int   (*pcre_callout)(pcre_callout_block *);
 | 
						|
 | 
						|
PCRE_EXP_DECL void *(*pcre16_malloc)(size_t);
 | 
						|
PCRE_EXP_DECL void  (*pcre16_free)(void *);
 | 
						|
PCRE_EXP_DECL void *(*pcre16_stack_malloc)(size_t);
 | 
						|
PCRE_EXP_DECL void  (*pcre16_stack_free)(void *);
 | 
						|
PCRE_EXP_DECL int   (*pcre16_callout)(pcre16_callout_block *);
 | 
						|
 | 
						|
PCRE_EXP_DECL void *(*pcre32_malloc)(size_t);
 | 
						|
PCRE_EXP_DECL void  (*pcre32_free)(void *);
 | 
						|
PCRE_EXP_DECL void *(*pcre32_stack_malloc)(size_t);
 | 
						|
PCRE_EXP_DECL void  (*pcre32_stack_free)(void *);
 | 
						|
PCRE_EXP_DECL int   (*pcre32_callout)(pcre32_callout_block *);
 | 
						|
#else   /* VPCOMPAT */
 | 
						|
PCRE_EXP_DECL void *pcre_malloc(size_t);
 | 
						|
PCRE_EXP_DECL void  pcre_free(void *);
 | 
						|
PCRE_EXP_DECL void *pcre_stack_malloc(size_t);
 | 
						|
PCRE_EXP_DECL void  pcre_stack_free(void *);
 | 
						|
PCRE_EXP_DECL int   pcre_callout(pcre_callout_block *);
 | 
						|
 | 
						|
PCRE_EXP_DECL void *pcre16_malloc(size_t);
 | 
						|
PCRE_EXP_DECL void  pcre16_free(void *);
 | 
						|
PCRE_EXP_DECL void *pcre16_stack_malloc(size_t);
 | 
						|
PCRE_EXP_DECL void  pcre16_stack_free(void *);
 | 
						|
PCRE_EXP_DECL int   pcre16_callout(pcre16_callout_block *);
 | 
						|
 | 
						|
PCRE_EXP_DECL void *pcre32_malloc(size_t);
 | 
						|
PCRE_EXP_DECL void  pcre32_free(void *);
 | 
						|
PCRE_EXP_DECL void *pcre32_stack_malloc(size_t);
 | 
						|
PCRE_EXP_DECL void  pcre32_stack_free(void *);
 | 
						|
PCRE_EXP_DECL int   pcre32_callout(pcre32_callout_block *);
 | 
						|
#endif  /* VPCOMPAT */
 | 
						|
 | 
						|
/* User defined callback which provides a stack just before the match starts. */
 | 
						|
 | 
						|
typedef pcre_jit_stack *(*pcre_jit_callback)(void *);
 | 
						|
typedef pcre16_jit_stack *(*pcre16_jit_callback)(void *);
 | 
						|
typedef pcre32_jit_stack *(*pcre32_jit_callback)(void *);
 | 
						|
 | 
						|
/* Exported PCRE functions */
 | 
						|
 | 
						|
PCRE_EXP_DECL pcre *pcre_compile(const char *, int, const char **, int *,
 | 
						|
                  const unsigned char *);
 | 
						|
PCRE_EXP_DECL pcre16 *pcre16_compile(PCRE_SPTR16, int, const char **, int *,
 | 
						|
                  const unsigned char *);
 | 
						|
PCRE_EXP_DECL pcre32 *pcre32_compile(PCRE_SPTR32, int, const char **, int *,
 | 
						|
                  const unsigned char *);
 | 
						|
PCRE_EXP_DECL pcre *pcre_compile2(const char *, int, int *, const char **,
 | 
						|
                  int *, const unsigned char *);
 | 
						|
PCRE_EXP_DECL pcre16 *pcre16_compile2(PCRE_SPTR16, int, int *, const char **,
 | 
						|
                  int *, const unsigned char *);
 | 
						|
PCRE_EXP_DECL pcre32 *pcre32_compile2(PCRE_SPTR32, int, int *, const char **,
 | 
						|
                  int *, const unsigned char *);
 | 
						|
PCRE_EXP_DECL int  pcre_config(int, void *);
 | 
						|
PCRE_EXP_DECL int  pcre16_config(int, void *);
 | 
						|
PCRE_EXP_DECL int  pcre32_config(int, void *);
 | 
						|
PCRE_EXP_DECL int  pcre_copy_named_substring(const pcre *, const char *,
 | 
						|
                  int *, int, const char *, char *, int);
 | 
						|
PCRE_EXP_DECL int  pcre16_copy_named_substring(const pcre16 *, PCRE_SPTR16,
 | 
						|
                  int *, int, PCRE_SPTR16, PCRE_UCHAR16 *, int);
 | 
						|
PCRE_EXP_DECL int  pcre32_copy_named_substring(const pcre32 *, PCRE_SPTR32,
 | 
						|
                  int *, int, PCRE_SPTR32, PCRE_UCHAR32 *, int);
 | 
						|
PCRE_EXP_DECL int  pcre_copy_substring(const char *, int *, int, int,
 | 
						|
                  char *, int);
 | 
						|
PCRE_EXP_DECL int  pcre16_copy_substring(PCRE_SPTR16, int *, int, int,
 | 
						|
                  PCRE_UCHAR16 *, int);
 | 
						|
PCRE_EXP_DECL int  pcre32_copy_substring(PCRE_SPTR32, int *, int, int,
 | 
						|
                  PCRE_UCHAR32 *, int);
 | 
						|
PCRE_EXP_DECL int  pcre_dfa_exec(const pcre *, const pcre_extra *,
 | 
						|
                  const char *, int, int, int, int *, int , int *, int);
 | 
						|
PCRE_EXP_DECL int  pcre16_dfa_exec(const pcre16 *, const pcre16_extra *,
 | 
						|
                  PCRE_SPTR16, int, int, int, int *, int , int *, int);
 | 
						|
PCRE_EXP_DECL int  pcre32_dfa_exec(const pcre32 *, const pcre32_extra *,
 | 
						|
                  PCRE_SPTR32, int, int, int, int *, int , int *, int);
 | 
						|
PCRE_EXP_DECL int  pcre_exec(const pcre *, const pcre_extra *, PCRE_SPTR,
 | 
						|
                   int, int, int, int *, int);
 | 
						|
PCRE_EXP_DECL int  pcre16_exec(const pcre16 *, const pcre16_extra *,
 | 
						|
                   PCRE_SPTR16, int, int, int, int *, int);
 | 
						|
PCRE_EXP_DECL int  pcre32_exec(const pcre32 *, const pcre32_extra *,
 | 
						|
                   PCRE_SPTR32, int, int, int, int *, int);
 | 
						|
PCRE_EXP_DECL int  pcre_jit_exec(const pcre *, const pcre_extra *,
 | 
						|
                   PCRE_SPTR, int, int, int, int *, int,
 | 
						|
                   pcre_jit_stack *);
 | 
						|
PCRE_EXP_DECL int  pcre16_jit_exec(const pcre16 *, const pcre16_extra *,
 | 
						|
                   PCRE_SPTR16, int, int, int, int *, int,
 | 
						|
                   pcre16_jit_stack *);
 | 
						|
PCRE_EXP_DECL int  pcre32_jit_exec(const pcre32 *, const pcre32_extra *,
 | 
						|
                   PCRE_SPTR32, int, int, int, int *, int,
 | 
						|
                   pcre32_jit_stack *);
 | 
						|
PCRE_EXP_DECL void pcre_free_substring(const char *);
 | 
						|
PCRE_EXP_DECL void pcre16_free_substring(PCRE_SPTR16);
 | 
						|
PCRE_EXP_DECL void pcre32_free_substring(PCRE_SPTR32);
 | 
						|
PCRE_EXP_DECL void pcre_free_substring_list(const char **);
 | 
						|
PCRE_EXP_DECL void pcre16_free_substring_list(PCRE_SPTR16 *);
 | 
						|
PCRE_EXP_DECL void pcre32_free_substring_list(PCRE_SPTR32 *);
 | 
						|
PCRE_EXP_DECL int  pcre_fullinfo(const pcre *, const pcre_extra *, int,
 | 
						|
                  void *);
 | 
						|
PCRE_EXP_DECL int  pcre16_fullinfo(const pcre16 *, const pcre16_extra *, int,
 | 
						|
                  void *);
 | 
						|
PCRE_EXP_DECL int  pcre32_fullinfo(const pcre32 *, const pcre32_extra *, int,
 | 
						|
                  void *);
 | 
						|
PCRE_EXP_DECL int  pcre_get_named_substring(const pcre *, const char *,
 | 
						|
                  int *, int, const char *, const char **);
 | 
						|
PCRE_EXP_DECL int  pcre16_get_named_substring(const pcre16 *, PCRE_SPTR16,
 | 
						|
                  int *, int, PCRE_SPTR16, PCRE_SPTR16 *);
 | 
						|
PCRE_EXP_DECL int  pcre32_get_named_substring(const pcre32 *, PCRE_SPTR32,
 | 
						|
                  int *, int, PCRE_SPTR32, PCRE_SPTR32 *);
 | 
						|
PCRE_EXP_DECL int  pcre_get_stringnumber(const pcre *, const char *);
 | 
						|
PCRE_EXP_DECL int  pcre16_get_stringnumber(const pcre16 *, PCRE_SPTR16);
 | 
						|
PCRE_EXP_DECL int  pcre32_get_stringnumber(const pcre32 *, PCRE_SPTR32);
 | 
						|
PCRE_EXP_DECL int  pcre_get_stringtable_entries(const pcre *, const char *,
 | 
						|
                  char **, char **);
 | 
						|
PCRE_EXP_DECL int  pcre16_get_stringtable_entries(const pcre16 *, PCRE_SPTR16,
 | 
						|
                  PCRE_UCHAR16 **, PCRE_UCHAR16 **);
 | 
						|
PCRE_EXP_DECL int  pcre32_get_stringtable_entries(const pcre32 *, PCRE_SPTR32,
 | 
						|
                  PCRE_UCHAR32 **, PCRE_UCHAR32 **);
 | 
						|
PCRE_EXP_DECL int  pcre_get_substring(const char *, int *, int, int,
 | 
						|
                  const char **);
 | 
						|
PCRE_EXP_DECL int  pcre16_get_substring(PCRE_SPTR16, int *, int, int,
 | 
						|
                  PCRE_SPTR16 *);
 | 
						|
PCRE_EXP_DECL int  pcre32_get_substring(PCRE_SPTR32, int *, int, int,
 | 
						|
                  PCRE_SPTR32 *);
 | 
						|
PCRE_EXP_DECL int  pcre_get_substring_list(const char *, int *, int,
 | 
						|
                  const char ***);
 | 
						|
PCRE_EXP_DECL int  pcre16_get_substring_list(PCRE_SPTR16, int *, int,
 | 
						|
                  PCRE_SPTR16 **);
 | 
						|
PCRE_EXP_DECL int  pcre32_get_substring_list(PCRE_SPTR32, int *, int,
 | 
						|
                  PCRE_SPTR32 **);
 | 
						|
PCRE_EXP_DECL const unsigned char *pcre_maketables(void);
 | 
						|
PCRE_EXP_DECL const unsigned char *pcre16_maketables(void);
 | 
						|
PCRE_EXP_DECL const unsigned char *pcre32_maketables(void);
 | 
						|
PCRE_EXP_DECL int  pcre_refcount(pcre *, int);
 | 
						|
PCRE_EXP_DECL int  pcre16_refcount(pcre16 *, int);
 | 
						|
PCRE_EXP_DECL int  pcre32_refcount(pcre32 *, int);
 | 
						|
PCRE_EXP_DECL pcre_extra *pcre_study(const pcre *, int, const char **);
 | 
						|
PCRE_EXP_DECL pcre16_extra *pcre16_study(const pcre16 *, int, const char **);
 | 
						|
PCRE_EXP_DECL pcre32_extra *pcre32_study(const pcre32 *, int, const char **);
 | 
						|
PCRE_EXP_DECL void pcre_free_study(pcre_extra *);
 | 
						|
PCRE_EXP_DECL void pcre16_free_study(pcre16_extra *);
 | 
						|
PCRE_EXP_DECL void pcre32_free_study(pcre32_extra *);
 | 
						|
PCRE_EXP_DECL const char *pcre_version(void);
 | 
						|
PCRE_EXP_DECL const char *pcre16_version(void);
 | 
						|
PCRE_EXP_DECL const char *pcre32_version(void);
 | 
						|
 | 
						|
/* Utility functions for byte order swaps. */
 | 
						|
PCRE_EXP_DECL int  pcre_pattern_to_host_byte_order(pcre *, pcre_extra *,
 | 
						|
                  const unsigned char *);
 | 
						|
PCRE_EXP_DECL int  pcre16_pattern_to_host_byte_order(pcre16 *, pcre16_extra *,
 | 
						|
                  const unsigned char *);
 | 
						|
PCRE_EXP_DECL int  pcre32_pattern_to_host_byte_order(pcre32 *, pcre32_extra *,
 | 
						|
                  const unsigned char *);
 | 
						|
PCRE_EXP_DECL int  pcre16_utf16_to_host_byte_order(PCRE_UCHAR16 *,
 | 
						|
                  PCRE_SPTR16, int, int *, int);
 | 
						|
PCRE_EXP_DECL int  pcre32_utf32_to_host_byte_order(PCRE_UCHAR32 *,
 | 
						|
                  PCRE_SPTR32, int, int *, int);
 | 
						|
 | 
						|
/* JIT compiler related functions. */
 | 
						|
 | 
						|
PCRE_EXP_DECL pcre_jit_stack *pcre_jit_stack_alloc(int, int);
 | 
						|
PCRE_EXP_DECL pcre16_jit_stack *pcre16_jit_stack_alloc(int, int);
 | 
						|
PCRE_EXP_DECL pcre32_jit_stack *pcre32_jit_stack_alloc(int, int);
 | 
						|
PCRE_EXP_DECL void pcre_jit_stack_free(pcre_jit_stack *);
 | 
						|
PCRE_EXP_DECL void pcre16_jit_stack_free(pcre16_jit_stack *);
 | 
						|
PCRE_EXP_DECL void pcre32_jit_stack_free(pcre32_jit_stack *);
 | 
						|
PCRE_EXP_DECL void pcre_assign_jit_stack(pcre_extra *,
 | 
						|
                  pcre_jit_callback, void *);
 | 
						|
PCRE_EXP_DECL void pcre16_assign_jit_stack(pcre16_extra *,
 | 
						|
                  pcre16_jit_callback, void *);
 | 
						|
PCRE_EXP_DECL void pcre32_assign_jit_stack(pcre32_extra *,
 | 
						|
                  pcre32_jit_callback, void *);
 | 
						|
 | 
						|
#ifdef __cplusplus
 | 
						|
}  /* extern "C" */
 | 
						|
#endif
 | 
						|
 | 
						|
#endif /* End of pcre.h */
 |