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-2009 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 |
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 |
|
|
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. */ |
100 |
|
|
101 |
#define PCRE_CASELESS 0x00000001 |
#define PCRE_CASELESS 0x00000001 |
102 |
#define PCRE_MULTILINE 0x00000002 |
#define PCRE_MULTILINE 0x00000002 |
113 |
#define PCRE_NO_AUTO_CAPTURE 0x00001000 |
#define PCRE_NO_AUTO_CAPTURE 0x00001000 |
114 |
#define PCRE_NO_UTF8_CHECK 0x00002000 |
#define PCRE_NO_UTF8_CHECK 0x00002000 |
115 |
#define PCRE_AUTO_CALLOUT 0x00004000 |
#define PCRE_AUTO_CALLOUT 0x00004000 |
116 |
#define PCRE_PARTIAL 0x00008000 |
#define PCRE_PARTIAL_SOFT 0x00008000 |
117 |
|
#define PCRE_PARTIAL 0x00008000 /* Backwards compatible synonym */ |
118 |
#define PCRE_DFA_SHORTEST 0x00010000 |
#define PCRE_DFA_SHORTEST 0x00010000 |
119 |
#define PCRE_DFA_RESTART 0x00020000 |
#define PCRE_DFA_RESTART 0x00020000 |
120 |
#define PCRE_FIRSTLINE 0x00040000 |
#define PCRE_FIRSTLINE 0x00040000 |
123 |
#define PCRE_NEWLINE_LF 0x00200000 |
#define PCRE_NEWLINE_LF 0x00200000 |
124 |
#define PCRE_NEWLINE_CRLF 0x00300000 |
#define PCRE_NEWLINE_CRLF 0x00300000 |
125 |
#define PCRE_NEWLINE_ANY 0x00400000 |
#define PCRE_NEWLINE_ANY 0x00400000 |
126 |
|
#define PCRE_NEWLINE_ANYCRLF 0x00500000 |
127 |
|
#define PCRE_BSR_ANYCRLF 0x00800000 |
128 |
|
#define PCRE_BSR_UNICODE 0x01000000 |
129 |
|
#define PCRE_JAVASCRIPT_COMPAT 0x02000000 |
130 |
|
#define PCRE_NO_START_OPTIMIZE 0x04000000 |
131 |
|
#define PCRE_NO_START_OPTIMISE 0x04000000 |
132 |
|
#define PCRE_PARTIAL_HARD 0x08000000 |
133 |
|
#define PCRE_NOTEMPTY_ATSTART 0x10000000 |
134 |
|
|
135 |
/* Exec-time and get/set-time error codes */ |
/* Exec-time and get/set-time error codes */ |
136 |
|
|
156 |
#define PCRE_ERROR_DFA_WSSIZE (-19) |
#define PCRE_ERROR_DFA_WSSIZE (-19) |
157 |
#define PCRE_ERROR_DFA_RECURSE (-20) |
#define PCRE_ERROR_DFA_RECURSE (-20) |
158 |
#define PCRE_ERROR_RECURSIONLIMIT (-21) |
#define PCRE_ERROR_RECURSIONLIMIT (-21) |
159 |
#define PCRE_ERROR_NULLWSLIMIT (-22) |
#define PCRE_ERROR_NULLWSLIMIT (-22) /* No longer actually used */ |
160 |
#define PCRE_ERROR_BADNEWLINE (-23) |
#define PCRE_ERROR_BADNEWLINE (-23) |
161 |
|
|
162 |
/* Request types for pcre_fullinfo() */ |
/* Request types for pcre_fullinfo() */ |
174 |
#define PCRE_INFO_NAMETABLE 9 |
#define PCRE_INFO_NAMETABLE 9 |
175 |
#define PCRE_INFO_STUDYSIZE 10 |
#define PCRE_INFO_STUDYSIZE 10 |
176 |
#define PCRE_INFO_DEFAULT_TABLES 11 |
#define PCRE_INFO_DEFAULT_TABLES 11 |
177 |
|
#define PCRE_INFO_OKPARTIAL 12 |
178 |
|
#define PCRE_INFO_JCHANGED 13 |
179 |
|
#define PCRE_INFO_HASCRORLF 14 |
180 |
|
|
181 |
/* 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 |
182 |
compatible. */ |
compatible. */ |
189 |
#define PCRE_CONFIG_STACKRECURSE 5 |
#define PCRE_CONFIG_STACKRECURSE 5 |
190 |
#define PCRE_CONFIG_UNICODE_PROPERTIES 6 |
#define PCRE_CONFIG_UNICODE_PROPERTIES 6 |
191 |
#define PCRE_CONFIG_MATCH_LIMIT_RECURSION 7 |
#define PCRE_CONFIG_MATCH_LIMIT_RECURSION 7 |
192 |
|
#define PCRE_CONFIG_BSR 8 |
193 |
|
|
194 |
/* Bit flags for the pcre_extra structure. Do not re-arrange or redefine |
/* Bit flags for the pcre_extra structure. Do not re-arrange or redefine |
195 |
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. */ |
256 |
have to take another form. */ |
have to take another form. */ |
257 |
|
|
258 |
#ifndef VPCOMPAT |
#ifndef VPCOMPAT |
259 |
PCRE_DATA_SCOPE void *(*pcre_malloc)(size_t); |
PCRE_EXP_DECL void *(*pcre_malloc)(size_t); |
260 |
PCRE_DATA_SCOPE void (*pcre_free)(void *); |
PCRE_EXP_DECL void (*pcre_free)(void *); |
261 |
PCRE_DATA_SCOPE void *(*pcre_stack_malloc)(size_t); |
PCRE_EXP_DECL void *(*pcre_stack_malloc)(size_t); |
262 |
PCRE_DATA_SCOPE void (*pcre_stack_free)(void *); |
PCRE_EXP_DECL void (*pcre_stack_free)(void *); |
263 |
PCRE_DATA_SCOPE int (*pcre_callout)(pcre_callout_block *); |
PCRE_EXP_DECL int (*pcre_callout)(pcre_callout_block *); |
264 |
#else /* VPCOMPAT */ |
#else /* VPCOMPAT */ |
265 |
PCRE_DATA_SCOPE void *pcre_malloc(size_t); |
PCRE_EXP_DECL void *pcre_malloc(size_t); |
266 |
PCRE_DATA_SCOPE void pcre_free(void *); |
PCRE_EXP_DECL void pcre_free(void *); |
267 |
PCRE_DATA_SCOPE void *pcre_stack_malloc(size_t); |
PCRE_EXP_DECL void *pcre_stack_malloc(size_t); |
268 |
PCRE_DATA_SCOPE void pcre_stack_free(void *); |
PCRE_EXP_DECL void pcre_stack_free(void *); |
269 |
PCRE_DATA_SCOPE int pcre_callout(pcre_callout_block *); |
PCRE_EXP_DECL int pcre_callout(pcre_callout_block *); |
270 |
#endif /* VPCOMPAT */ |
#endif /* VPCOMPAT */ |
271 |
|
|
272 |
/* Exported PCRE functions */ |
/* Exported PCRE functions */ |
273 |
|
|
274 |
PCRE_DATA_SCOPE pcre *pcre_compile(const char *, int, const char **, int *, |
PCRE_EXP_DECL pcre *pcre_compile(const char *, int, const char **, int *, |
275 |
const unsigned char *); |
const unsigned char *); |
276 |
PCRE_DATA_SCOPE pcre *pcre_compile2(const char *, int, int *, const char **, |
PCRE_EXP_DECL pcre *pcre_compile2(const char *, int, int *, const char **, |
277 |
int *, const unsigned char *); |
int *, const unsigned char *); |
278 |
PCRE_DATA_SCOPE int pcre_config(int, void *); |
PCRE_EXP_DECL int pcre_config(int, void *); |
279 |
PCRE_DATA_SCOPE int pcre_copy_named_substring(const pcre *, const char *, |
PCRE_EXP_DECL int pcre_copy_named_substring(const pcre *, const char *, |
280 |
int *, int, const char *, char *, int); |
int *, int, const char *, char *, int); |
281 |
PCRE_DATA_SCOPE int pcre_copy_substring(const char *, int *, int, int, char *, |
PCRE_EXP_DECL int pcre_copy_substring(const char *, int *, int, int, char *, |
282 |
int); |
int); |
283 |
PCRE_DATA_SCOPE int pcre_dfa_exec(const pcre *, const pcre_extra *, |
PCRE_EXP_DECL int pcre_dfa_exec(const pcre *, const pcre_extra *, |
284 |
const char *, int, int, int, int *, int , int *, int); |
const char *, int, int, int, int *, int , int *, int); |
285 |
PCRE_DATA_SCOPE int pcre_exec(const pcre *, const pcre_extra *, PCRE_SPTR, |
PCRE_EXP_DECL int pcre_exec(const pcre *, const pcre_extra *, PCRE_SPTR, |
286 |
int, int, int, int *, int); |
int, int, int, int *, int); |
287 |
PCRE_DATA_SCOPE void pcre_free_substring(const char *); |
PCRE_EXP_DECL void pcre_free_substring(const char *); |
288 |
PCRE_DATA_SCOPE void pcre_free_substring_list(const char **); |
PCRE_EXP_DECL void pcre_free_substring_list(const char **); |
289 |
PCRE_DATA_SCOPE int pcre_fullinfo(const pcre *, const pcre_extra *, int, |
PCRE_EXP_DECL int pcre_fullinfo(const pcre *, const pcre_extra *, int, |
290 |
void *); |
void *); |
291 |
PCRE_DATA_SCOPE int pcre_get_named_substring(const pcre *, const char *, |
PCRE_EXP_DECL int pcre_get_named_substring(const pcre *, const char *, |
292 |
int *, int, const char *, const char **); |
int *, int, const char *, const char **); |
293 |
PCRE_DATA_SCOPE int pcre_get_stringnumber(const pcre *, const char *); |
PCRE_EXP_DECL int pcre_get_stringnumber(const pcre *, const char *); |
294 |
PCRE_DATA_SCOPE int pcre_get_stringtable_entries(const pcre *, const char *, |
PCRE_EXP_DECL int pcre_get_stringtable_entries(const pcre *, const char *, |
295 |
char **, char **); |
char **, char **); |
296 |
PCRE_DATA_SCOPE int pcre_get_substring(const char *, int *, int, int, |
PCRE_EXP_DECL int pcre_get_substring(const char *, int *, int, int, |
297 |
const char **); |
const char **); |
298 |
PCRE_DATA_SCOPE int pcre_get_substring_list(const char *, int *, int, |
PCRE_EXP_DECL int pcre_get_substring_list(const char *, int *, int, |
299 |
const char ***); |
const char ***); |
300 |
PCRE_DATA_SCOPE int pcre_info(const pcre *, int *, int *); |
PCRE_EXP_DECL int pcre_info(const pcre *, int *, int *); |
301 |
PCRE_DATA_SCOPE const unsigned char *pcre_maketables(void); |
PCRE_EXP_DECL const unsigned char *pcre_maketables(void); |
302 |
PCRE_DATA_SCOPE int pcre_refcount(pcre *, int); |
PCRE_EXP_DECL int pcre_refcount(pcre *, int); |
303 |
PCRE_DATA_SCOPE pcre_extra *pcre_study(const pcre *, int, const char **); |
PCRE_EXP_DECL pcre_extra *pcre_study(const pcre *, int, const char **); |
304 |
PCRE_DATA_SCOPE const char *pcre_version(void); |
PCRE_EXP_DECL const char *pcre_version(void); |
305 |
|
|
306 |
#ifdef __cplusplus |
#ifdef __cplusplus |
307 |
} /* extern "C" */ |
} /* extern "C" */ |