1/*************************************************
2*       Perl-Compatible Regular Expressions      *
3*************************************************/
4
5/* This is the public header file for the PCRE library, second API, to be
6#included by applications that call PCRE2 functions.
7
8           Copyright (c) 2016-2018 University of Cambridge
9
10-----------------------------------------------------------------------------
11Redistribution and use in source and binary forms, with or without
12modification, are permitted provided that the following conditions are met:
13
14    * Redistributions of source code must retain the above copyright notice,
15      this list of conditions and the following disclaimer.
16
17    * Redistributions in binary form must reproduce the above copyright
18      notice, this list of conditions and the following disclaimer in the
19      documentation and/or other materials provided with the distribution.
20
21    * Neither the name of the University of Cambridge nor the names of its
22      contributors may be used to endorse or promote products derived from
23      this software without specific prior written permission.
24
25THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
26AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
27IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
28ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE
29LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
30CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
31SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
32INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
33CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
34ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
35POSSIBILITY OF SUCH DAMAGE.
36-----------------------------------------------------------------------------
37*/
38
39#ifndef PCRE2_H_IDEMPOTENT_GUARD
40#define PCRE2_H_IDEMPOTENT_GUARD
41
42/* The current PCRE version information. */
43
44#define PCRE2_MAJOR           @PCRE2_MAJOR@
45#define PCRE2_MINOR           @PCRE2_MINOR@
46#define PCRE2_PRERELEASE      @PCRE2_PRERELEASE@
47#define PCRE2_DATE            @PCRE2_DATE@
48
49/* For the benefit of systems without stdint.h, an alternative is to use
50inttypes.h. The existence of these headers is checked by configure or CMake. */
51
52#define PCRE2_HAVE_STDINT_H   @PCRE2_HAVE_STDINT_H@
53#define PCRE2_HAVE_INTTYPES_H @PCRE2_HAVE_INTTYPES_H@
54
55/* When an application links to a PCRE DLL in Windows, the symbols that are
56imported have to be identified as such. When building PCRE2, the appropriate
57export setting is defined in pcre2_internal.h, which includes this file. So we
58don't change existing definitions of PCRE2_EXP_DECL. */
59
60#if defined(_WIN32) && !defined(PCRE2_STATIC)
61#  ifndef PCRE2_EXP_DECL
62#    define PCRE2_EXP_DECL  extern __declspec(dllimport)
63#  endif
64#endif
65
66/* By default, we use the standard "extern" declarations. */
67
68#ifndef PCRE2_EXP_DECL
69#  ifdef __cplusplus
70#    define PCRE2_EXP_DECL  extern "C"
71#  else
72#    define PCRE2_EXP_DECL  extern
73#  endif
74#endif
75
76/* When compiling with the MSVC compiler, it is sometimes necessary to include
77a "calling convention" before exported function names. (This is secondhand
78information; I know nothing about MSVC myself). For example, something like
79
80  void __cdecl function(....)
81
82might be needed. In order so make this easy, all the exported functions have
83PCRE2_CALL_CONVENTION just before their names. It is rarely needed; if not
84set, we ensure here that it has no effect. */
85
86#ifndef PCRE2_CALL_CONVENTION
87#define PCRE2_CALL_CONVENTION
88#endif
89
90/* Have to include limits.h, stdlib.h and stdint.h (or inttypes.h) to ensure
91that size_t and uint8_t, UCHAR_MAX, etc are defined. If the system has neither
92header, the relevant values must be provided by some other means. */
93
94#include <limits.h>
95#include <stdlib.h>
96
97#if PCRE2_HAVE_STDINT_H
98#include <stdint.h>
99#elif PCRE2_HAVE_INTTYPES_H
100#include <inttypes.h>
101#endif
102
103/* Allow for C++ users compiling this directly. */
104
105#ifdef __cplusplus
106extern "C" {
107#endif
108
109/* The following option bits can be passed to pcre2_compile(), pcre2_match(),
110or pcre2_dfa_match(). PCRE2_NO_UTF_CHECK affects only the function to which it
111is passed. Put these bits at the most significant end of the options word so
112others can be added next to them */
113
114#define PCRE2_ANCHORED            0x80000000u
115#define PCRE2_NO_UTF_CHECK        0x40000000u
116#define PCRE2_ENDANCHORED         0x20000000u
117
118/* The following option bits can be passed only to pcre2_compile(). However,
119they may affect compilation, JIT compilation, and/or interpretive execution.
120The following tags indicate which:
121
122C   alters what is compiled by pcre2_compile()
123J   alters what is compiled by pcre2_jit_compile()
124M   is inspected during pcre2_match() execution
125D   is inspected during pcre2_dfa_match() execution
126*/
127
128#define PCRE2_ALLOW_EMPTY_CLASS   0x00000001u  /* C       */
129#define PCRE2_ALT_BSUX            0x00000002u  /* C       */
130#define PCRE2_AUTO_CALLOUT        0x00000004u  /* C       */
131#define PCRE2_CASELESS            0x00000008u  /* C       */
132#define PCRE2_DOLLAR_ENDONLY      0x00000010u  /*   J M D */
133#define PCRE2_DOTALL              0x00000020u  /* C       */
134#define PCRE2_DUPNAMES            0x00000040u  /* C       */
135#define PCRE2_EXTENDED            0x00000080u  /* C       */
136#define PCRE2_FIRSTLINE           0x00000100u  /*   J M D */
137#define PCRE2_MATCH_UNSET_BACKREF 0x00000200u  /* C J M   */
138#define PCRE2_MULTILINE           0x00000400u  /* C       */
139#define PCRE2_NEVER_UCP           0x00000800u  /* C       */
140#define PCRE2_NEVER_UTF           0x00001000u  /* C       */
141#define PCRE2_NO_AUTO_CAPTURE     0x00002000u  /* C       */
142#define PCRE2_NO_AUTO_POSSESS     0x00004000u  /* C       */
143#define PCRE2_NO_DOTSTAR_ANCHOR   0x00008000u  /* C       */
144#define PCRE2_NO_START_OPTIMIZE   0x00010000u  /*   J M D */
145#define PCRE2_UCP                 0x00020000u  /* C J M D */
146#define PCRE2_UNGREEDY            0x00040000u  /* C       */
147#define PCRE2_UTF                 0x00080000u  /* C J M D */
148#define PCRE2_NEVER_BACKSLASH_C   0x00100000u  /* C       */
149#define PCRE2_ALT_CIRCUMFLEX      0x00200000u  /*   J M D */
150#define PCRE2_ALT_VERBNAMES       0x00400000u  /* C       */
151#define PCRE2_USE_OFFSET_LIMIT    0x00800000u  /*   J M D */
152#define PCRE2_EXTENDED_MORE       0x01000000u  /* C       */
153#define PCRE2_LITERAL             0x02000000u  /* C       */
154
155/* An additional compile options word is available in the compile context. */
156
157#define PCRE2_EXTRA_ALLOW_SURROGATE_ESCAPES  0x00000001u  /* C */
158#define PCRE2_EXTRA_BAD_ESCAPE_IS_LITERAL    0x00000002u  /* C */
159#define PCRE2_EXTRA_MATCH_WORD               0x00000004u  /* C */
160#define PCRE2_EXTRA_MATCH_LINE               0x00000008u  /* C */
161
162/* These are for pcre2_jit_compile(). */
163
164#define PCRE2_JIT_COMPLETE        0x00000001u  /* For full matching */
165#define PCRE2_JIT_PARTIAL_SOFT    0x00000002u
166#define PCRE2_JIT_PARTIAL_HARD    0x00000004u
167
168/* These are for pcre2_match(), pcre2_dfa_match(), and pcre2_jit_match(). Note
169that PCRE2_ANCHORED and PCRE2_NO_UTF_CHECK can also be passed to these
170functions (though pcre2_jit_match() ignores the latter since it bypasses all
171sanity checks). */
172
173#define PCRE2_NOTBOL              0x00000001u
174#define PCRE2_NOTEOL              0x00000002u
175#define PCRE2_NOTEMPTY            0x00000004u  /* ) These two must be kept */
176#define PCRE2_NOTEMPTY_ATSTART    0x00000008u  /* ) adjacent to each other. */
177#define PCRE2_PARTIAL_SOFT        0x00000010u
178#define PCRE2_PARTIAL_HARD        0x00000020u
179
180/* These are additional options for pcre2_dfa_match(). */
181
182#define PCRE2_DFA_RESTART         0x00000040u
183#define PCRE2_DFA_SHORTEST        0x00000080u
184
185/* These are additional options for pcre2_substitute(), which passes any others
186through to pcre2_match(). */
187
188#define PCRE2_SUBSTITUTE_GLOBAL           0x00000100u
189#define PCRE2_SUBSTITUTE_EXTENDED         0x00000200u
190#define PCRE2_SUBSTITUTE_UNSET_EMPTY      0x00000400u
191#define PCRE2_SUBSTITUTE_UNKNOWN_UNSET    0x00000800u
192#define PCRE2_SUBSTITUTE_OVERFLOW_LENGTH  0x00001000u
193
194/* A further option for pcre2_match(), not allowed for pcre2_dfa_match(),
195ignored for pcre2_jit_match(). */
196
197#define PCRE2_NO_JIT              0x00002000u
198
199/* Options for pcre2_pattern_convert(). */
200
201#define PCRE2_CONVERT_UTF                    0x00000001u
202#define PCRE2_CONVERT_NO_UTF_CHECK           0x00000002u
203#define PCRE2_CONVERT_POSIX_BASIC            0x00000004u
204#define PCRE2_CONVERT_POSIX_EXTENDED         0x00000008u
205#define PCRE2_CONVERT_GLOB                   0x00000010u
206#define PCRE2_CONVERT_GLOB_NO_WILD_SEPARATOR 0x00000030u
207#define PCRE2_CONVERT_GLOB_NO_STARSTAR       0x00000050u
208
209/* Newline and \R settings, for use in compile contexts. The newline values
210must be kept in step with values set in config.h and both sets must all be
211greater than zero. */
212
213#define PCRE2_NEWLINE_CR          1
214#define PCRE2_NEWLINE_LF          2
215#define PCRE2_NEWLINE_CRLF        3
216#define PCRE2_NEWLINE_ANY         4
217#define PCRE2_NEWLINE_ANYCRLF     5
218#define PCRE2_NEWLINE_NUL         6
219
220#define PCRE2_BSR_UNICODE         1
221#define PCRE2_BSR_ANYCRLF         2
222
223/* Error codes for pcre2_compile(). Some of these are also used by
224pcre2_pattern_convert(). */
225
226#define PCRE2_ERROR_END_BACKSLASH                  101
227#define PCRE2_ERROR_END_BACKSLASH_C                102
228#define PCRE2_ERROR_UNKNOWN_ESCAPE                 103
229#define PCRE2_ERROR_QUANTIFIER_OUT_OF_ORDER        104
230#define PCRE2_ERROR_QUANTIFIER_TOO_BIG             105
231#define PCRE2_ERROR_MISSING_SQUARE_BRACKET         106
232#define PCRE2_ERROR_ESCAPE_INVALID_IN_CLASS        107
233#define PCRE2_ERROR_CLASS_RANGE_ORDER              108
234#define PCRE2_ERROR_QUANTIFIER_INVALID             109
235#define PCRE2_ERROR_INTERNAL_UNEXPECTED_REPEAT     110
236#define PCRE2_ERROR_INVALID_AFTER_PARENS_QUERY     111
237#define PCRE2_ERROR_POSIX_CLASS_NOT_IN_CLASS       112
238#define PCRE2_ERROR_POSIX_NO_SUPPORT_COLLATING     113
239#define PCRE2_ERROR_MISSING_CLOSING_PARENTHESIS    114
240#define PCRE2_ERROR_BAD_SUBPATTERN_REFERENCE       115
241#define PCRE2_ERROR_NULL_PATTERN                   116
242#define PCRE2_ERROR_BAD_OPTIONS                    117
243#define PCRE2_ERROR_MISSING_COMMENT_CLOSING        118
244#define PCRE2_ERROR_PARENTHESES_NEST_TOO_DEEP      119
245#define PCRE2_ERROR_PATTERN_TOO_LARGE              120
246#define PCRE2_ERROR_HEAP_FAILED                    121
247#define PCRE2_ERROR_UNMATCHED_CLOSING_PARENTHESIS  122
248#define PCRE2_ERROR_INTERNAL_CODE_OVERFLOW         123
249#define PCRE2_ERROR_MISSING_CONDITION_CLOSING      124
250#define PCRE2_ERROR_LOOKBEHIND_NOT_FIXED_LENGTH    125
251#define PCRE2_ERROR_ZERO_RELATIVE_REFERENCE        126
252#define PCRE2_ERROR_TOO_MANY_CONDITION_BRANCHES    127
253#define PCRE2_ERROR_CONDITION_ASSERTION_EXPECTED   128
254#define PCRE2_ERROR_BAD_RELATIVE_REFERENCE         129
255#define PCRE2_ERROR_UNKNOWN_POSIX_CLASS            130
256#define PCRE2_ERROR_INTERNAL_STUDY_ERROR           131
257#define PCRE2_ERROR_UNICODE_NOT_SUPPORTED          132
258#define PCRE2_ERROR_PARENTHESES_STACK_CHECK        133
259#define PCRE2_ERROR_CODE_POINT_TOO_BIG             134
260#define PCRE2_ERROR_LOOKBEHIND_TOO_COMPLICATED     135
261#define PCRE2_ERROR_LOOKBEHIND_INVALID_BACKSLASH_C 136
262#define PCRE2_ERROR_UNSUPPORTED_ESCAPE_SEQUENCE    137
263#define PCRE2_ERROR_CALLOUT_NUMBER_TOO_BIG         138
264#define PCRE2_ERROR_MISSING_CALLOUT_CLOSING        139
265#define PCRE2_ERROR_ESCAPE_INVALID_IN_VERB         140
266#define PCRE2_ERROR_UNRECOGNIZED_AFTER_QUERY_P     141
267#define PCRE2_ERROR_MISSING_NAME_TERMINATOR        142
268#define PCRE2_ERROR_DUPLICATE_SUBPATTERN_NAME      143
269#define PCRE2_ERROR_INVALID_SUBPATTERN_NAME        144
270#define PCRE2_ERROR_UNICODE_PROPERTIES_UNAVAILABLE 145
271#define PCRE2_ERROR_MALFORMED_UNICODE_PROPERTY     146
272#define PCRE2_ERROR_UNKNOWN_UNICODE_PROPERTY       147
273#define PCRE2_ERROR_SUBPATTERN_NAME_TOO_LONG       148
274#define PCRE2_ERROR_TOO_MANY_NAMED_SUBPATTERNS     149
275#define PCRE2_ERROR_CLASS_INVALID_RANGE            150
276#define PCRE2_ERROR_OCTAL_BYTE_TOO_BIG             151
277#define PCRE2_ERROR_INTERNAL_OVERRAN_WORKSPACE     152
278#define PCRE2_ERROR_INTERNAL_MISSING_SUBPATTERN    153
279#define PCRE2_ERROR_DEFINE_TOO_MANY_BRANCHES       154
280#define PCRE2_ERROR_BACKSLASH_O_MISSING_BRACE      155
281#define PCRE2_ERROR_INTERNAL_UNKNOWN_NEWLINE       156
282#define PCRE2_ERROR_BACKSLASH_G_SYNTAX             157
283#define PCRE2_ERROR_PARENS_QUERY_R_MISSING_CLOSING 158
284/* Error 159 is obsolete and should now never occur */
285#define PCRE2_ERROR_VERB_ARGUMENT_NOT_ALLOWED      159
286#define PCRE2_ERROR_VERB_UNKNOWN                   160
287#define PCRE2_ERROR_SUBPATTERN_NUMBER_TOO_BIG      161
288#define PCRE2_ERROR_SUBPATTERN_NAME_EXPECTED       162
289#define PCRE2_ERROR_INTERNAL_PARSED_OVERFLOW       163
290#define PCRE2_ERROR_INVALID_OCTAL                  164
291#define PCRE2_ERROR_SUBPATTERN_NAMES_MISMATCH      165
292#define PCRE2_ERROR_MARK_MISSING_ARGUMENT          166
293#define PCRE2_ERROR_INVALID_HEXADECIMAL            167
294#define PCRE2_ERROR_BACKSLASH_C_SYNTAX             168
295#define PCRE2_ERROR_BACKSLASH_K_SYNTAX             169
296#define PCRE2_ERROR_INTERNAL_BAD_CODE_LOOKBEHINDS  170
297#define PCRE2_ERROR_BACKSLASH_N_IN_CLASS           171
298#define PCRE2_ERROR_CALLOUT_STRING_TOO_LONG        172
299#define PCRE2_ERROR_UNICODE_DISALLOWED_CODE_POINT  173
300#define PCRE2_ERROR_UTF_IS_DISABLED                174
301#define PCRE2_ERROR_UCP_IS_DISABLED                175
302#define PCRE2_ERROR_VERB_NAME_TOO_LONG             176
303#define PCRE2_ERROR_BACKSLASH_U_CODE_POINT_TOO_BIG 177
304#define PCRE2_ERROR_MISSING_OCTAL_OR_HEX_DIGITS    178
305#define PCRE2_ERROR_VERSION_CONDITION_SYNTAX       179
306#define PCRE2_ERROR_INTERNAL_BAD_CODE_AUTO_POSSESS 180
307#define PCRE2_ERROR_CALLOUT_NO_STRING_DELIMITER    181
308#define PCRE2_ERROR_CALLOUT_BAD_STRING_DELIMITER   182
309#define PCRE2_ERROR_BACKSLASH_C_CALLER_DISABLED    183
310#define PCRE2_ERROR_QUERY_BARJX_NEST_TOO_DEEP      184
311#define PCRE2_ERROR_BACKSLASH_C_LIBRARY_DISABLED   185
312#define PCRE2_ERROR_PATTERN_TOO_COMPLICATED        186
313#define PCRE2_ERROR_LOOKBEHIND_TOO_LONG            187
314#define PCRE2_ERROR_PATTERN_STRING_TOO_LONG        188
315#define PCRE2_ERROR_INTERNAL_BAD_CODE              189
316#define PCRE2_ERROR_INTERNAL_BAD_CODE_IN_SKIP      190
317#define PCRE2_ERROR_NO_SURROGATES_IN_UTF16         191
318#define PCRE2_ERROR_BAD_LITERAL_OPTIONS            192
319#define PCRE2_ERROR_SUPPORTED_ONLY_IN_UNICODE      193
320#define PCRE2_ERROR_INVALID_HYPHEN_IN_OPTIONS      194
321
322
323/* "Expected" matching error codes: no match and partial match. */
324
325#define PCRE2_ERROR_NOMATCH          (-1)
326#define PCRE2_ERROR_PARTIAL          (-2)
327
328/* Error codes for UTF-8 validity checks */
329
330#define PCRE2_ERROR_UTF8_ERR1        (-3)
331#define PCRE2_ERROR_UTF8_ERR2        (-4)
332#define PCRE2_ERROR_UTF8_ERR3        (-5)
333#define PCRE2_ERROR_UTF8_ERR4        (-6)
334#define PCRE2_ERROR_UTF8_ERR5        (-7)
335#define PCRE2_ERROR_UTF8_ERR6        (-8)
336#define PCRE2_ERROR_UTF8_ERR7        (-9)
337#define PCRE2_ERROR_UTF8_ERR8       (-10)
338#define PCRE2_ERROR_UTF8_ERR9       (-11)
339#define PCRE2_ERROR_UTF8_ERR10      (-12)
340#define PCRE2_ERROR_UTF8_ERR11      (-13)
341#define PCRE2_ERROR_UTF8_ERR12      (-14)
342#define PCRE2_ERROR_UTF8_ERR13      (-15)
343#define PCRE2_ERROR_UTF8_ERR14      (-16)
344#define PCRE2_ERROR_UTF8_ERR15      (-17)
345#define PCRE2_ERROR_UTF8_ERR16      (-18)
346#define PCRE2_ERROR_UTF8_ERR17      (-19)
347#define PCRE2_ERROR_UTF8_ERR18      (-20)
348#define PCRE2_ERROR_UTF8_ERR19      (-21)
349#define PCRE2_ERROR_UTF8_ERR20      (-22)
350#define PCRE2_ERROR_UTF8_ERR21      (-23)
351
352/* Error codes for UTF-16 validity checks */
353
354#define PCRE2_ERROR_UTF16_ERR1      (-24)
355#define PCRE2_ERROR_UTF16_ERR2      (-25)
356#define PCRE2_ERROR_UTF16_ERR3      (-26)
357
358/* Error codes for UTF-32 validity checks */
359
360#define PCRE2_ERROR_UTF32_ERR1      (-27)
361#define PCRE2_ERROR_UTF32_ERR2      (-28)
362
363/* Miscellaneous error codes for pcre2[_dfa]_match(), substring extraction
364functions, context functions, and serializing functions. They are in numerical
365order. Originally they were in alphabetical order too, but now that PCRE2 is
366released, the numbers must not be changed. */
367
368#define PCRE2_ERROR_BADDATA           (-29)
369#define PCRE2_ERROR_MIXEDTABLES       (-30)  /* Name was changed */
370#define PCRE2_ERROR_BADMAGIC          (-31)
371#define PCRE2_ERROR_BADMODE           (-32)
372#define PCRE2_ERROR_BADOFFSET         (-33)
373#define PCRE2_ERROR_BADOPTION         (-34)
374#define PCRE2_ERROR_BADREPLACEMENT    (-35)
375#define PCRE2_ERROR_BADUTFOFFSET      (-36)
376#define PCRE2_ERROR_CALLOUT           (-37)  /* Never used by PCRE2 itself */
377#define PCRE2_ERROR_DFA_BADRESTART    (-38)
378#define PCRE2_ERROR_DFA_RECURSE       (-39)
379#define PCRE2_ERROR_DFA_UCOND         (-40)
380#define PCRE2_ERROR_DFA_UFUNC         (-41)
381#define PCRE2_ERROR_DFA_UITEM         (-42)
382#define PCRE2_ERROR_DFA_WSSIZE        (-43)
383#define PCRE2_ERROR_INTERNAL          (-44)
384#define PCRE2_ERROR_JIT_BADOPTION     (-45)
385#define PCRE2_ERROR_JIT_STACKLIMIT    (-46)
386#define PCRE2_ERROR_MATCHLIMIT        (-47)
387#define PCRE2_ERROR_NOMEMORY          (-48)
388#define PCRE2_ERROR_NOSUBSTRING       (-49)
389#define PCRE2_ERROR_NOUNIQUESUBSTRING (-50)
390#define PCRE2_ERROR_NULL              (-51)
391#define PCRE2_ERROR_RECURSELOOP       (-52)
392#define PCRE2_ERROR_DEPTHLIMIT        (-53)
393#define PCRE2_ERROR_RECURSIONLIMIT    (-53)  /* Obsolete synonym */
394#define PCRE2_ERROR_UNAVAILABLE       (-54)
395#define PCRE2_ERROR_UNSET             (-55)
396#define PCRE2_ERROR_BADOFFSETLIMIT    (-56)
397#define PCRE2_ERROR_BADREPESCAPE      (-57)
398#define PCRE2_ERROR_REPMISSINGBRACE   (-58)
399#define PCRE2_ERROR_BADSUBSTITUTION   (-59)
400#define PCRE2_ERROR_BADSUBSPATTERN    (-60)
401#define PCRE2_ERROR_TOOMANYREPLACE    (-61)
402#define PCRE2_ERROR_BADSERIALIZEDDATA (-62)
403#define PCRE2_ERROR_HEAPLIMIT         (-63)
404#define PCRE2_ERROR_CONVERT_SYNTAX    (-64)
405#define PCRE2_ERROR_INTERNAL_DUPMATCH (-65)
406
407
408/* Request types for pcre2_pattern_info() */
409
410#define PCRE2_INFO_ALLOPTIONS            0
411#define PCRE2_INFO_ARGOPTIONS            1
412#define PCRE2_INFO_BACKREFMAX            2
413#define PCRE2_INFO_BSR                   3
414#define PCRE2_INFO_CAPTURECOUNT          4
415#define PCRE2_INFO_FIRSTCODEUNIT         5
416#define PCRE2_INFO_FIRSTCODETYPE         6
417#define PCRE2_INFO_FIRSTBITMAP           7
418#define PCRE2_INFO_HASCRORLF             8
419#define PCRE2_INFO_JCHANGED              9
420#define PCRE2_INFO_JITSIZE              10
421#define PCRE2_INFO_LASTCODEUNIT         11
422#define PCRE2_INFO_LASTCODETYPE         12
423#define PCRE2_INFO_MATCHEMPTY           13
424#define PCRE2_INFO_MATCHLIMIT           14
425#define PCRE2_INFO_MAXLOOKBEHIND        15
426#define PCRE2_INFO_MINLENGTH            16
427#define PCRE2_INFO_NAMECOUNT            17
428#define PCRE2_INFO_NAMEENTRYSIZE        18
429#define PCRE2_INFO_NAMETABLE            19
430#define PCRE2_INFO_NEWLINE              20
431#define PCRE2_INFO_DEPTHLIMIT           21
432#define PCRE2_INFO_RECURSIONLIMIT       21  /* Obsolete synonym */
433#define PCRE2_INFO_SIZE                 22
434#define PCRE2_INFO_HASBACKSLASHC        23
435#define PCRE2_INFO_FRAMESIZE            24
436#define PCRE2_INFO_HEAPLIMIT            25
437#define PCRE2_INFO_EXTRAOPTIONS         26
438
439/* Request types for pcre2_config(). */
440
441#define PCRE2_CONFIG_BSR                     0
442#define PCRE2_CONFIG_JIT                     1
443#define PCRE2_CONFIG_JITTARGET               2
444#define PCRE2_CONFIG_LINKSIZE                3
445#define PCRE2_CONFIG_MATCHLIMIT              4
446#define PCRE2_CONFIG_NEWLINE                 5
447#define PCRE2_CONFIG_PARENSLIMIT             6
448#define PCRE2_CONFIG_DEPTHLIMIT              7
449#define PCRE2_CONFIG_RECURSIONLIMIT          7  /* Obsolete synonym */
450#define PCRE2_CONFIG_STACKRECURSE            8  /* Obsolete */
451#define PCRE2_CONFIG_UNICODE                 9
452#define PCRE2_CONFIG_UNICODE_VERSION        10
453#define PCRE2_CONFIG_VERSION                11
454#define PCRE2_CONFIG_HEAPLIMIT              12
455#define PCRE2_CONFIG_NEVER_BACKSLASH_C      13
456#define PCRE2_CONFIG_COMPILED_WIDTHS        14
457
458
459/* Types for code units in patterns and subject strings. */
460
461typedef uint8_t  PCRE2_UCHAR8;
462typedef uint16_t PCRE2_UCHAR16;
463typedef uint32_t PCRE2_UCHAR32;
464
465typedef const PCRE2_UCHAR8  *PCRE2_SPTR8;
466typedef const PCRE2_UCHAR16 *PCRE2_SPTR16;
467typedef const PCRE2_UCHAR32 *PCRE2_SPTR32;
468
469/* The PCRE2_SIZE type is used for all string lengths and offsets in PCRE2,
470including pattern offsets for errors and subject offsets after a match. We
471define special values to indicate zero-terminated strings and unset offsets in
472the offset vector (ovector). */
473
474#define PCRE2_SIZE            size_t
475#define PCRE2_SIZE_MAX        SIZE_MAX
476#define PCRE2_ZERO_TERMINATED (~(PCRE2_SIZE)0)
477#define PCRE2_UNSET           (~(PCRE2_SIZE)0)
478
479/* Generic types for opaque structures and JIT callback functions. These
480declarations are defined in a macro that is expanded for each width later. */
481
482#define PCRE2_TYPES_LIST \
483struct pcre2_real_general_context; \
484typedef struct pcre2_real_general_context pcre2_general_context; \
485\
486struct pcre2_real_compile_context; \
487typedef struct pcre2_real_compile_context pcre2_compile_context; \
488\
489struct pcre2_real_match_context; \
490typedef struct pcre2_real_match_context pcre2_match_context; \
491\
492struct pcre2_real_convert_context; \
493typedef struct pcre2_real_convert_context pcre2_convert_context; \
494\
495struct pcre2_real_code; \
496typedef struct pcre2_real_code pcre2_code; \
497\
498struct pcre2_real_match_data; \
499typedef struct pcre2_real_match_data pcre2_match_data; \
500\
501struct pcre2_real_jit_stack; \
502typedef struct pcre2_real_jit_stack pcre2_jit_stack; \
503\
504typedef pcre2_jit_stack *(*pcre2_jit_callback)(void *);
505
506
507/* The structure for passing out data via the pcre_callout_function. We use a
508structure so that new fields can be added on the end in future versions,
509without changing the API of the function, thereby allowing old clients to work
510without modification. Define the generic version in a macro; the width-specific
511versions are generated from this macro below. */
512
513/* Flags for the callout_flags field. These are cleared after a callout. */
514
515#define PCRE2_CALLOUT_STARTMATCH    0x00000001u  /* Set for each bumpalong */
516#define PCRE2_CALLOUT_BACKTRACK     0x00000002u  /* Set after a backtrack */
517
518#define PCRE2_STRUCTURE_LIST \
519typedef struct pcre2_callout_block { \
520  uint32_t      version;           /* Identifies version of block */ \
521  /* ------------------------ Version 0 ------------------------------- */ \
522  uint32_t      callout_number;    /* Number compiled into pattern */ \
523  uint32_t      capture_top;       /* Max current capture */ \
524  uint32_t      capture_last;      /* Most recently closed capture */ \
525  PCRE2_SIZE   *offset_vector;     /* The offset vector */ \
526  PCRE2_SPTR    mark;              /* Pointer to current mark or NULL */ \
527  PCRE2_SPTR    subject;           /* The subject being matched */ \
528  PCRE2_SIZE    subject_length;    /* The length of the subject */ \
529  PCRE2_SIZE    start_match;       /* Offset to start of this match attempt */ \
530  PCRE2_SIZE    current_position;  /* Where we currently are in the subject */ \
531  PCRE2_SIZE    pattern_position;  /* Offset to next item in the pattern */ \
532  PCRE2_SIZE    next_item_length;  /* Length of next item in the pattern */ \
533  /* ------------------- Added for Version 1 -------------------------- */ \
534  PCRE2_SIZE    callout_string_offset; /* Offset to string within pattern */ \
535  PCRE2_SIZE    callout_string_length; /* Length of string compiled into pattern */ \
536  PCRE2_SPTR    callout_string;    /* String compiled into pattern */ \
537  /* ------------------- Added for Version 2 -------------------------- */ \
538  uint32_t      callout_flags;     /* See above for list */ \
539  /* ------------------------------------------------------------------ */ \
540} pcre2_callout_block; \
541\
542typedef struct pcre2_callout_enumerate_block { \
543  uint32_t      version;           /* Identifies version of block */ \
544  /* ------------------------ Version 0 ------------------------------- */ \
545  PCRE2_SIZE    pattern_position;  /* Offset to next item in the pattern */ \
546  PCRE2_SIZE    next_item_length;  /* Length of next item in the pattern */ \
547  uint32_t      callout_number;    /* Number compiled into pattern */ \
548  PCRE2_SIZE    callout_string_offset; /* Offset to string within pattern */ \
549  PCRE2_SIZE    callout_string_length; /* Length of string compiled into pattern */ \
550  PCRE2_SPTR    callout_string;    /* String compiled into pattern */ \
551  /* ------------------------------------------------------------------ */ \
552} pcre2_callout_enumerate_block;
553
554
555/* List the generic forms of all other functions in macros, which will be
556expanded for each width below. Start with functions that give general
557information. */
558
559#define PCRE2_GENERAL_INFO_FUNCTIONS \
560PCRE2_EXP_DECL int PCRE2_CALL_CONVENTION pcre2_config(uint32_t, void *);
561
562
563/* Functions for manipulating contexts. */
564
565#define PCRE2_GENERAL_CONTEXT_FUNCTIONS \
566PCRE2_EXP_DECL pcre2_general_context PCRE2_CALL_CONVENTION \
567  *pcre2_general_context_copy(pcre2_general_context *); \
568PCRE2_EXP_DECL pcre2_general_context PCRE2_CALL_CONVENTION \
569  *pcre2_general_context_create(void *(*)(PCRE2_SIZE, void *), \
570    void (*)(void *, void *), void *); \
571PCRE2_EXP_DECL void PCRE2_CALL_CONVENTION \
572  pcre2_general_context_free(pcre2_general_context *);
573
574#define PCRE2_COMPILE_CONTEXT_FUNCTIONS \
575PCRE2_EXP_DECL pcre2_compile_context PCRE2_CALL_CONVENTION \
576  *pcre2_compile_context_copy(pcre2_compile_context *); \
577PCRE2_EXP_DECL pcre2_compile_context PCRE2_CALL_CONVENTION \
578  *pcre2_compile_context_create(pcre2_general_context *);\
579PCRE2_EXP_DECL void PCRE2_CALL_CONVENTION \
580  pcre2_compile_context_free(pcre2_compile_context *); \
581PCRE2_EXP_DECL int PCRE2_CALL_CONVENTION \
582  pcre2_set_bsr(pcre2_compile_context *, uint32_t); \
583PCRE2_EXP_DECL int PCRE2_CALL_CONVENTION \
584  pcre2_set_character_tables(pcre2_compile_context *, const unsigned char *); \
585PCRE2_EXP_DECL int PCRE2_CALL_CONVENTION \
586  pcre2_set_compile_extra_options(pcre2_compile_context *, uint32_t); \
587PCRE2_EXP_DECL int PCRE2_CALL_CONVENTION \
588  pcre2_set_max_pattern_length(pcre2_compile_context *, PCRE2_SIZE); \
589PCRE2_EXP_DECL int PCRE2_CALL_CONVENTION \
590  pcre2_set_newline(pcre2_compile_context *, uint32_t); \
591PCRE2_EXP_DECL int PCRE2_CALL_CONVENTION \
592  pcre2_set_parens_nest_limit(pcre2_compile_context *, uint32_t); \
593PCRE2_EXP_DECL int PCRE2_CALL_CONVENTION \
594  pcre2_set_compile_recursion_guard(pcre2_compile_context *, \
595    int (*)(uint32_t, void *), void *);
596
597#define PCRE2_MATCH_CONTEXT_FUNCTIONS \
598PCRE2_EXP_DECL pcre2_match_context PCRE2_CALL_CONVENTION \
599  *pcre2_match_context_copy(pcre2_match_context *); \
600PCRE2_EXP_DECL pcre2_match_context PCRE2_CALL_CONVENTION \
601  *pcre2_match_context_create(pcre2_general_context *); \
602PCRE2_EXP_DECL void PCRE2_CALL_CONVENTION \
603  pcre2_match_context_free(pcre2_match_context *); \
604PCRE2_EXP_DECL int PCRE2_CALL_CONVENTION \
605  pcre2_set_callout(pcre2_match_context *, \
606    int (*)(pcre2_callout_block *, void *), void *); \
607PCRE2_EXP_DECL int PCRE2_CALL_CONVENTION \
608  pcre2_set_depth_limit(pcre2_match_context *, uint32_t); \
609PCRE2_EXP_DECL int PCRE2_CALL_CONVENTION \
610  pcre2_set_heap_limit(pcre2_match_context *, uint32_t); \
611PCRE2_EXP_DECL int PCRE2_CALL_CONVENTION \
612  pcre2_set_match_limit(pcre2_match_context *, uint32_t); \
613PCRE2_EXP_DECL int PCRE2_CALL_CONVENTION \
614  pcre2_set_offset_limit(pcre2_match_context *, PCRE2_SIZE); \
615PCRE2_EXP_DECL int PCRE2_CALL_CONVENTION \
616  pcre2_set_recursion_limit(pcre2_match_context *, uint32_t); \
617PCRE2_EXP_DECL int PCRE2_CALL_CONVENTION \
618  pcre2_set_recursion_memory_management(pcre2_match_context *, \
619    void *(*)(PCRE2_SIZE, void *), void (*)(void *, void *), void *);
620
621#define PCRE2_CONVERT_CONTEXT_FUNCTIONS \
622PCRE2_EXP_DECL pcre2_convert_context PCRE2_CALL_CONVENTION \
623  *pcre2_convert_context_copy(pcre2_convert_context *); \
624PCRE2_EXP_DECL pcre2_convert_context PCRE2_CALL_CONVENTION \
625  *pcre2_convert_context_create(pcre2_general_context *); \
626PCRE2_EXP_DECL void PCRE2_CALL_CONVENTION \
627  pcre2_convert_context_free(pcre2_convert_context *); \
628PCRE2_EXP_DECL int PCRE2_CALL_CONVENTION \
629  pcre2_set_glob_escape(pcre2_convert_context *, uint32_t); \
630PCRE2_EXP_DECL int PCRE2_CALL_CONVENTION \
631  pcre2_set_glob_separator(pcre2_convert_context *, uint32_t);
632
633
634/* Functions concerned with compiling a pattern to PCRE internal code. */
635
636#define PCRE2_COMPILE_FUNCTIONS \
637PCRE2_EXP_DECL pcre2_code PCRE2_CALL_CONVENTION \
638  *pcre2_compile(PCRE2_SPTR, PCRE2_SIZE, uint32_t, int *, PCRE2_SIZE *, \
639    pcre2_compile_context *); \
640PCRE2_EXP_DECL void PCRE2_CALL_CONVENTION \
641  pcre2_code_free(pcre2_code *); \
642PCRE2_EXP_DECL pcre2_code PCRE2_CALL_CONVENTION \
643  *pcre2_code_copy(const pcre2_code *); \
644PCRE2_EXP_DECL pcre2_code PCRE2_CALL_CONVENTION \
645  *pcre2_code_copy_with_tables(const pcre2_code *);
646
647
648/* Functions that give information about a compiled pattern. */
649
650#define PCRE2_PATTERN_INFO_FUNCTIONS \
651PCRE2_EXP_DECL int PCRE2_CALL_CONVENTION \
652  pcre2_pattern_info(const pcre2_code *, uint32_t, void *); \
653PCRE2_EXP_DECL int PCRE2_CALL_CONVENTION \
654  pcre2_callout_enumerate(const pcre2_code *, \
655    int (*)(pcre2_callout_enumerate_block *, void *), void *);
656
657
658/* Functions for running a match and inspecting the result. */
659
660#define PCRE2_MATCH_FUNCTIONS \
661PCRE2_EXP_DECL pcre2_match_data PCRE2_CALL_CONVENTION \
662  *pcre2_match_data_create(uint32_t, pcre2_general_context *); \
663PCRE2_EXP_DECL pcre2_match_data PCRE2_CALL_CONVENTION \
664  *pcre2_match_data_create_from_pattern(const pcre2_code *, \
665    pcre2_general_context *); \
666PCRE2_EXP_DECL int PCRE2_CALL_CONVENTION \
667  pcre2_dfa_match(const pcre2_code *, PCRE2_SPTR, PCRE2_SIZE, PCRE2_SIZE, \
668    uint32_t, pcre2_match_data *, pcre2_match_context *, int *, PCRE2_SIZE); \
669PCRE2_EXP_DECL int PCRE2_CALL_CONVENTION \
670  pcre2_match(const pcre2_code *, PCRE2_SPTR, PCRE2_SIZE, PCRE2_SIZE, \
671    uint32_t, pcre2_match_data *, pcre2_match_context *); \
672PCRE2_EXP_DECL void PCRE2_CALL_CONVENTION \
673  pcre2_match_data_free(pcre2_match_data *); \
674PCRE2_EXP_DECL PCRE2_SPTR PCRE2_CALL_CONVENTION \
675  pcre2_get_mark(pcre2_match_data *); \
676PCRE2_EXP_DECL uint32_t PCRE2_CALL_CONVENTION \
677  pcre2_get_ovector_count(pcre2_match_data *); \
678PCRE2_EXP_DECL PCRE2_SIZE PCRE2_CALL_CONVENTION \
679  *pcre2_get_ovector_pointer(pcre2_match_data *); \
680PCRE2_EXP_DECL PCRE2_SIZE PCRE2_CALL_CONVENTION \
681  pcre2_get_startchar(pcre2_match_data *);
682
683
684/* Convenience functions for handling matched substrings. */
685
686#define PCRE2_SUBSTRING_FUNCTIONS \
687PCRE2_EXP_DECL int PCRE2_CALL_CONVENTION \
688  pcre2_substring_copy_byname(pcre2_match_data *, PCRE2_SPTR, PCRE2_UCHAR *, \
689    PCRE2_SIZE *); \
690PCRE2_EXP_DECL int PCRE2_CALL_CONVENTION \
691  pcre2_substring_copy_bynumber(pcre2_match_data *, uint32_t, PCRE2_UCHAR *, \
692    PCRE2_SIZE *); \
693PCRE2_EXP_DECL void PCRE2_CALL_CONVENTION \
694  pcre2_substring_free(PCRE2_UCHAR *); \
695PCRE2_EXP_DECL int PCRE2_CALL_CONVENTION \
696  pcre2_substring_get_byname(pcre2_match_data *, PCRE2_SPTR, PCRE2_UCHAR **, \
697    PCRE2_SIZE *); \
698PCRE2_EXP_DECL int PCRE2_CALL_CONVENTION \
699  pcre2_substring_get_bynumber(pcre2_match_data *, uint32_t, PCRE2_UCHAR **, \
700    PCRE2_SIZE *); \
701PCRE2_EXP_DECL int PCRE2_CALL_CONVENTION \
702  pcre2_substring_length_byname(pcre2_match_data *, PCRE2_SPTR, PCRE2_SIZE *); \
703PCRE2_EXP_DECL int PCRE2_CALL_CONVENTION \
704  pcre2_substring_length_bynumber(pcre2_match_data *, uint32_t, PCRE2_SIZE *); \
705PCRE2_EXP_DECL int PCRE2_CALL_CONVENTION \
706  pcre2_substring_nametable_scan(const pcre2_code *, PCRE2_SPTR, PCRE2_SPTR *, \
707    PCRE2_SPTR *); \
708PCRE2_EXP_DECL int PCRE2_CALL_CONVENTION \
709  pcre2_substring_number_from_name(const pcre2_code *, PCRE2_SPTR); \
710PCRE2_EXP_DECL void PCRE2_CALL_CONVENTION \
711  pcre2_substring_list_free(PCRE2_SPTR *); \
712PCRE2_EXP_DECL int PCRE2_CALL_CONVENTION \
713  pcre2_substring_list_get(pcre2_match_data *, PCRE2_UCHAR ***, PCRE2_SIZE **);
714
715/* Functions for serializing / deserializing compiled patterns. */
716
717#define PCRE2_SERIALIZE_FUNCTIONS \
718PCRE2_EXP_DECL int32_t PCRE2_CALL_CONVENTION \
719  pcre2_serialize_encode(const pcre2_code **, int32_t, uint8_t **, \
720    PCRE2_SIZE *, pcre2_general_context *); \
721PCRE2_EXP_DECL int32_t PCRE2_CALL_CONVENTION \
722  pcre2_serialize_decode(pcre2_code **, int32_t, const uint8_t *, \
723    pcre2_general_context *); \
724PCRE2_EXP_DECL int32_t PCRE2_CALL_CONVENTION \
725  pcre2_serialize_get_number_of_codes(const uint8_t *); \
726PCRE2_EXP_DECL void PCRE2_CALL_CONVENTION \
727  pcre2_serialize_free(uint8_t *);
728
729
730/* Convenience function for match + substitute. */
731
732#define PCRE2_SUBSTITUTE_FUNCTION \
733PCRE2_EXP_DECL int PCRE2_CALL_CONVENTION \
734  pcre2_substitute(const pcre2_code *, PCRE2_SPTR, PCRE2_SIZE, PCRE2_SIZE, \
735    uint32_t, pcre2_match_data *, pcre2_match_context *, PCRE2_SPTR, \
736    PCRE2_SIZE, PCRE2_UCHAR *, PCRE2_SIZE *);
737
738
739/* Functions for converting pattern source strings. */
740
741#define PCRE2_CONVERT_FUNCTIONS \
742PCRE2_EXP_DECL int PCRE2_CALL_CONVENTION \
743  pcre2_pattern_convert(PCRE2_SPTR, PCRE2_SIZE, uint32_t, PCRE2_UCHAR **, \
744    PCRE2_SIZE *, pcre2_convert_context *); \
745PCRE2_EXP_DECL void PCRE2_CALL_CONVENTION \
746  pcre2_converted_pattern_free(PCRE2_UCHAR *);
747
748
749/* Functions for JIT processing */
750
751#define PCRE2_JIT_FUNCTIONS \
752PCRE2_EXP_DECL int PCRE2_CALL_CONVENTION \
753  pcre2_jit_compile(pcre2_code *, uint32_t); \
754PCRE2_EXP_DECL int PCRE2_CALL_CONVENTION \
755  pcre2_jit_match(const pcre2_code *, PCRE2_SPTR, PCRE2_SIZE, PCRE2_SIZE, \
756    uint32_t, pcre2_match_data *, pcre2_match_context *); \
757PCRE2_EXP_DECL void PCRE2_CALL_CONVENTION \
758  pcre2_jit_free_unused_memory(pcre2_general_context *); \
759PCRE2_EXP_DECL pcre2_jit_stack PCRE2_CALL_CONVENTION \
760  *pcre2_jit_stack_create(PCRE2_SIZE, PCRE2_SIZE, pcre2_general_context *); \
761PCRE2_EXP_DECL void PCRE2_CALL_CONVENTION \
762  pcre2_jit_stack_assign(pcre2_match_context *, pcre2_jit_callback, void *); \
763PCRE2_EXP_DECL void PCRE2_CALL_CONVENTION \
764  pcre2_jit_stack_free(pcre2_jit_stack *);
765
766
767/* Other miscellaneous functions. */
768
769#define PCRE2_OTHER_FUNCTIONS \
770PCRE2_EXP_DECL int PCRE2_CALL_CONVENTION \
771  pcre2_get_error_message(int, PCRE2_UCHAR *, PCRE2_SIZE); \
772PCRE2_EXP_DECL const uint8_t PCRE2_CALL_CONVENTION \
773  *pcre2_maketables(pcre2_general_context *); \
774
775
776/* Define macros that generate width-specific names from generic versions. The
777three-level macro scheme is necessary to get the macros expanded when we want
778them to be. First we get the width from PCRE2_LOCAL_WIDTH, which is used for
779generating three versions of everything below. After that, PCRE2_SUFFIX will be
780re-defined to use PCRE2_CODE_UNIT_WIDTH, for use when macros such as
781pcre2_compile are called by application code. */
782
783#define PCRE2_JOIN(a,b) a ## b
784#define PCRE2_GLUE(a,b) PCRE2_JOIN(a,b)
785#define PCRE2_SUFFIX(a) PCRE2_GLUE(a,PCRE2_LOCAL_WIDTH)
786
787
788/* Data types */
789
790#define PCRE2_UCHAR                 PCRE2_SUFFIX(PCRE2_UCHAR)
791#define PCRE2_SPTR                  PCRE2_SUFFIX(PCRE2_SPTR)
792
793#define pcre2_code                  PCRE2_SUFFIX(pcre2_code_)
794#define pcre2_jit_callback          PCRE2_SUFFIX(pcre2_jit_callback_)
795#define pcre2_jit_stack             PCRE2_SUFFIX(pcre2_jit_stack_)
796
797#define pcre2_real_code             PCRE2_SUFFIX(pcre2_real_code_)
798#define pcre2_real_general_context  PCRE2_SUFFIX(pcre2_real_general_context_)
799#define pcre2_real_compile_context  PCRE2_SUFFIX(pcre2_real_compile_context_)
800#define pcre2_real_convert_context  PCRE2_SUFFIX(pcre2_real_convert_context_)
801#define pcre2_real_match_context    PCRE2_SUFFIX(pcre2_real_match_context_)
802#define pcre2_real_jit_stack        PCRE2_SUFFIX(pcre2_real_jit_stack_)
803#define pcre2_real_match_data       PCRE2_SUFFIX(pcre2_real_match_data_)
804
805
806/* Data blocks */
807
808#define pcre2_callout_block            PCRE2_SUFFIX(pcre2_callout_block_)
809#define pcre2_callout_enumerate_block  PCRE2_SUFFIX(pcre2_callout_enumerate_block_)
810#define pcre2_general_context          PCRE2_SUFFIX(pcre2_general_context_)
811#define pcre2_compile_context          PCRE2_SUFFIX(pcre2_compile_context_)
812#define pcre2_convert_context          PCRE2_SUFFIX(pcre2_convert_context_)
813#define pcre2_match_context            PCRE2_SUFFIX(pcre2_match_context_)
814#define pcre2_match_data               PCRE2_SUFFIX(pcre2_match_data_)
815
816
817/* Functions: the complete list in alphabetical order */
818
819#define pcre2_callout_enumerate               PCRE2_SUFFIX(pcre2_callout_enumerate_)
820#define pcre2_code_copy                       PCRE2_SUFFIX(pcre2_code_copy_)
821#define pcre2_code_copy_with_tables           PCRE2_SUFFIX(pcre2_code_copy_with_tables_)
822#define pcre2_code_free                       PCRE2_SUFFIX(pcre2_code_free_)
823#define pcre2_compile                         PCRE2_SUFFIX(pcre2_compile_)
824#define pcre2_compile_context_copy            PCRE2_SUFFIX(pcre2_compile_context_copy_)
825#define pcre2_compile_context_create          PCRE2_SUFFIX(pcre2_compile_context_create_)
826#define pcre2_compile_context_free            PCRE2_SUFFIX(pcre2_compile_context_free_)
827#define pcre2_config                          PCRE2_SUFFIX(pcre2_config_)
828#define pcre2_convert_context_copy            PCRE2_SUFFIX(pcre2_convert_context_copy_)
829#define pcre2_convert_context_create          PCRE2_SUFFIX(pcre2_convert_context_create_)
830#define pcre2_convert_context_free            PCRE2_SUFFIX(pcre2_convert_context_free_)
831#define pcre2_converted_pattern_free          PCRE2_SUFFIX(pcre2_converted_pattern_free_)
832#define pcre2_dfa_match                       PCRE2_SUFFIX(pcre2_dfa_match_)
833#define pcre2_general_context_copy            PCRE2_SUFFIX(pcre2_general_context_copy_)
834#define pcre2_general_context_create          PCRE2_SUFFIX(pcre2_general_context_create_)
835#define pcre2_general_context_free            PCRE2_SUFFIX(pcre2_general_context_free_)
836#define pcre2_get_error_message               PCRE2_SUFFIX(pcre2_get_error_message_)
837#define pcre2_get_mark                        PCRE2_SUFFIX(pcre2_get_mark_)
838#define pcre2_get_ovector_pointer             PCRE2_SUFFIX(pcre2_get_ovector_pointer_)
839#define pcre2_get_ovector_count               PCRE2_SUFFIX(pcre2_get_ovector_count_)
840#define pcre2_get_startchar                   PCRE2_SUFFIX(pcre2_get_startchar_)
841#define pcre2_jit_compile                     PCRE2_SUFFIX(pcre2_jit_compile_)
842#define pcre2_jit_match                       PCRE2_SUFFIX(pcre2_jit_match_)
843#define pcre2_jit_free_unused_memory          PCRE2_SUFFIX(pcre2_jit_free_unused_memory_)
844#define pcre2_jit_stack_assign                PCRE2_SUFFIX(pcre2_jit_stack_assign_)
845#define pcre2_jit_stack_create                PCRE2_SUFFIX(pcre2_jit_stack_create_)
846#define pcre2_jit_stack_free                  PCRE2_SUFFIX(pcre2_jit_stack_free_)
847#define pcre2_maketables                      PCRE2_SUFFIX(pcre2_maketables_)
848#define pcre2_match                           PCRE2_SUFFIX(pcre2_match_)
849#define pcre2_match_context_copy              PCRE2_SUFFIX(pcre2_match_context_copy_)
850#define pcre2_match_context_create            PCRE2_SUFFIX(pcre2_match_context_create_)
851#define pcre2_match_context_free              PCRE2_SUFFIX(pcre2_match_context_free_)
852#define pcre2_match_data_create               PCRE2_SUFFIX(pcre2_match_data_create_)
853#define pcre2_match_data_create_from_pattern  PCRE2_SUFFIX(pcre2_match_data_create_from_pattern_)
854#define pcre2_match_data_free                 PCRE2_SUFFIX(pcre2_match_data_free_)
855#define pcre2_pattern_convert                 PCRE2_SUFFIX(pcre2_pattern_convert_)
856#define pcre2_pattern_info                    PCRE2_SUFFIX(pcre2_pattern_info_)
857#define pcre2_serialize_decode                PCRE2_SUFFIX(pcre2_serialize_decode_)
858#define pcre2_serialize_encode                PCRE2_SUFFIX(pcre2_serialize_encode_)
859#define pcre2_serialize_free                  PCRE2_SUFFIX(pcre2_serialize_free_)
860#define pcre2_serialize_get_number_of_codes   PCRE2_SUFFIX(pcre2_serialize_get_number_of_codes_)
861#define pcre2_set_bsr                         PCRE2_SUFFIX(pcre2_set_bsr_)
862#define pcre2_set_callout                     PCRE2_SUFFIX(pcre2_set_callout_)
863#define pcre2_set_character_tables            PCRE2_SUFFIX(pcre2_set_character_tables_)
864#define pcre2_set_compile_extra_options       PCRE2_SUFFIX(pcre2_set_compile_extra_options_)
865#define pcre2_set_compile_recursion_guard     PCRE2_SUFFIX(pcre2_set_compile_recursion_guard_)
866#define pcre2_set_depth_limit                 PCRE2_SUFFIX(pcre2_set_depth_limit_)
867#define pcre2_set_glob_escape                 PCRE2_SUFFIX(pcre2_set_glob_escape_)
868#define pcre2_set_glob_separator              PCRE2_SUFFIX(pcre2_set_glob_separator_)
869#define pcre2_set_heap_limit                  PCRE2_SUFFIX(pcre2_set_heap_limit_)
870#define pcre2_set_match_limit                 PCRE2_SUFFIX(pcre2_set_match_limit_)
871#define pcre2_set_max_pattern_length          PCRE2_SUFFIX(pcre2_set_max_pattern_length_)
872#define pcre2_set_newline                     PCRE2_SUFFIX(pcre2_set_newline_)
873#define pcre2_set_parens_nest_limit           PCRE2_SUFFIX(pcre2_set_parens_nest_limit_)
874#define pcre2_set_offset_limit                PCRE2_SUFFIX(pcre2_set_offset_limit_)
875#define pcre2_substitute                      PCRE2_SUFFIX(pcre2_substitute_)
876#define pcre2_substring_copy_byname           PCRE2_SUFFIX(pcre2_substring_copy_byname_)
877#define pcre2_substring_copy_bynumber         PCRE2_SUFFIX(pcre2_substring_copy_bynumber_)
878#define pcre2_substring_free                  PCRE2_SUFFIX(pcre2_substring_free_)
879#define pcre2_substring_get_byname            PCRE2_SUFFIX(pcre2_substring_get_byname_)
880#define pcre2_substring_get_bynumber          PCRE2_SUFFIX(pcre2_substring_get_bynumber_)
881#define pcre2_substring_length_byname         PCRE2_SUFFIX(pcre2_substring_length_byname_)
882#define pcre2_substring_length_bynumber       PCRE2_SUFFIX(pcre2_substring_length_bynumber_)
883#define pcre2_substring_list_get              PCRE2_SUFFIX(pcre2_substring_list_get_)
884#define pcre2_substring_list_free             PCRE2_SUFFIX(pcre2_substring_list_free_)
885#define pcre2_substring_nametable_scan        PCRE2_SUFFIX(pcre2_substring_nametable_scan_)
886#define pcre2_substring_number_from_name      PCRE2_SUFFIX(pcre2_substring_number_from_name_)
887
888/* Keep this old function name for backwards compatibility */
889#define pcre2_set_recursion_limit PCRE2_SUFFIX(pcre2_set_recursion_limit_)
890
891/* Keep this obsolete function for backwards compatibility: it is now a noop. */
892#define pcre2_set_recursion_memory_management PCRE2_SUFFIX(pcre2_set_recursion_memory_management_)
893
894/* Now generate all three sets of width-specific structures and function
895prototypes. */
896
897#define PCRE2_TYPES_STRUCTURES_AND_FUNCTIONS \
898PCRE2_TYPES_LIST \
899PCRE2_STRUCTURE_LIST \
900PCRE2_GENERAL_INFO_FUNCTIONS \
901PCRE2_GENERAL_CONTEXT_FUNCTIONS \
902PCRE2_COMPILE_CONTEXT_FUNCTIONS \
903PCRE2_CONVERT_CONTEXT_FUNCTIONS \
904PCRE2_CONVERT_FUNCTIONS \
905PCRE2_MATCH_CONTEXT_FUNCTIONS \
906PCRE2_COMPILE_FUNCTIONS \
907PCRE2_PATTERN_INFO_FUNCTIONS \
908PCRE2_MATCH_FUNCTIONS \
909PCRE2_SUBSTRING_FUNCTIONS \
910PCRE2_SERIALIZE_FUNCTIONS \
911PCRE2_SUBSTITUTE_FUNCTION \
912PCRE2_JIT_FUNCTIONS \
913PCRE2_OTHER_FUNCTIONS
914
915#define PCRE2_LOCAL_WIDTH 8
916PCRE2_TYPES_STRUCTURES_AND_FUNCTIONS
917#undef PCRE2_LOCAL_WIDTH
918
919#define PCRE2_LOCAL_WIDTH 16
920PCRE2_TYPES_STRUCTURES_AND_FUNCTIONS
921#undef PCRE2_LOCAL_WIDTH
922
923#define PCRE2_LOCAL_WIDTH 32
924PCRE2_TYPES_STRUCTURES_AND_FUNCTIONS
925#undef PCRE2_LOCAL_WIDTH
926
927/* Undefine the list macros; they are no longer needed. */
928
929#undef PCRE2_TYPES_LIST
930#undef PCRE2_STRUCTURE_LIST
931#undef PCRE2_GENERAL_INFO_FUNCTIONS
932#undef PCRE2_GENERAL_CONTEXT_FUNCTIONS
933#undef PCRE2_COMPILE_CONTEXT_FUNCTIONS
934#undef PCRE2_CONVERT_CONTEXT_FUNCTIONS
935#undef PCRE2_MATCH_CONTEXT_FUNCTIONS
936#undef PCRE2_COMPILE_FUNCTIONS
937#undef PCRE2_PATTERN_INFO_FUNCTIONS
938#undef PCRE2_MATCH_FUNCTIONS
939#undef PCRE2_SUBSTRING_FUNCTIONS
940#undef PCRE2_SERIALIZE_FUNCTIONS
941#undef PCRE2_SUBSTITUTE_FUNCTION
942#undef PCRE2_JIT_FUNCTIONS
943#undef PCRE2_OTHER_FUNCTIONS
944#undef PCRE2_TYPES_STRUCTURES_AND_FUNCTIONS
945
946/* PCRE2_CODE_UNIT_WIDTH must be defined. If it is 8, 16, or 32, redefine
947PCRE2_SUFFIX to use it. If it is 0, undefine the other macros and make
948PCRE2_SUFFIX a no-op. Otherwise, generate an error. */
949
950#undef PCRE2_SUFFIX
951#ifndef PCRE2_CODE_UNIT_WIDTH
952#error PCRE2_CODE_UNIT_WIDTH must be defined before including pcre2.h.
953#error Use 8, 16, or 32; or 0 for a multi-width application.
954#else  /* PCRE2_CODE_UNIT_WIDTH is defined */
955#if PCRE2_CODE_UNIT_WIDTH == 8 || \
956    PCRE2_CODE_UNIT_WIDTH == 16 || \
957    PCRE2_CODE_UNIT_WIDTH == 32
958#define PCRE2_SUFFIX(a) PCRE2_GLUE(a, PCRE2_CODE_UNIT_WIDTH)
959#elif PCRE2_CODE_UNIT_WIDTH == 0
960#undef PCRE2_JOIN
961#undef PCRE2_GLUE
962#define PCRE2_SUFFIX(a) a
963#else
964#error PCRE2_CODE_UNIT_WIDTH must be 0, 8, 16, or 32.
965#endif
966#endif  /* PCRE2_CODE_UNIT_WIDTH is defined */
967
968#ifdef __cplusplus
969}  /* extern "C" */
970#endif
971
972#endif  /* PCRE2_H_IDEMPOTENT_GUARD */
973
974/* End of pcre2.h */
975