blob: 875225d77e50401cfe4fcec0ae3d0c59b9b090f0 [file] [log] [blame]
Victor Stinner759e30e2017-09-05 01:58:08 +02001/*
2 __ __ _
3 ___\ \/ /_ __ __ _| |_
4 / _ \\ /| '_ \ / _` | __|
5 | __// \| |_) | (_| | |_
6 \___/_/\_\ .__/ \__,_|\__|
7 |_| XML parser
8
9 Copyright (c) 1997-2000 Thai Open Source Software Center Ltd
10 Copyright (c) 2000-2017 Expat development team
11 Licensed under the MIT license:
12
13 Permission is hereby granted, free of charge, to any person obtaining
14 a copy of this software and associated documentation files (the
15 "Software"), to deal in the Software without restriction, including
16 without limitation the rights to use, copy, modify, merge, publish,
17 distribute, sublicense, and/or sell copies of the Software, and to permit
18 persons to whom the Software is furnished to do so, subject to the
19 following conditions:
20
21 The above copyright notice and this permission notice shall be included
22 in all copies or substantial portions of the Software.
23
24 THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
25 EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
26 MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN
27 NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM,
28 DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR
29 OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE
30 USE OR OTHER DEALINGS IN THE SOFTWARE.
Fred Drake31d485c2004-08-03 07:06:22 +000031*/
32
Thomas Wouters0e3f5912006-08-11 14:57:12 +000033#ifndef Expat_External_INCLUDED
34#define Expat_External_INCLUDED 1
35
Fred Drake31d485c2004-08-03 07:06:22 +000036/* External API definitions */
37
Gregory P. Smith7c6309c2012-07-14 14:12:35 -070038#if defined(_MSC_EXTENSIONS) && !defined(__BEOS__) && !defined(__CYGWIN__)
Benjamin Peterson4e211002018-06-26 19:25:45 -070039# define XML_USE_MSC_EXTENSIONS 1
Fred Drake31d485c2004-08-03 07:06:22 +000040#endif
41
42/* Expat tries very hard to make the API boundary very specifically
43 defined. There are two macros defined to control this boundary;
44 each of these can be defined before including this header to
45 achieve some different behavior, but doing so it not recommended or
46 tested frequently.
47
48 XMLCALL - The calling convention to use for all calls across the
49 "library boundary." This will default to cdecl, and
50 try really hard to tell the compiler that's what we
51 want.
52
53 XMLIMPORT - Whatever magic is needed to note that a function is
54 to be imported from a dynamically loaded library
55 (.dll, .so, or .sl, depending on your platform).
56
57 The XMLCALL macro was added in Expat 1.95.7. The only one which is
58 expected to be directly useful in client code is XMLCALL.
59
60 Note that on at least some Unix versions, the Expat library must be
61 compiled with the cdecl calling convention as the default since
62 system headers may assume the cdecl convention.
63*/
64#ifndef XMLCALL
Benjamin Peterson4e211002018-06-26 19:25:45 -070065# if defined(_MSC_VER)
66# define XMLCALL __cdecl
67# elif defined(__GNUC__) && defined(__i386) && !defined(__INTEL_COMPILER)
68# define XMLCALL __attribute__((cdecl))
69# else
Fred Drake31d485c2004-08-03 07:06:22 +000070/* For any platform which uses this definition and supports more than
71 one calling convention, we need to extend this definition to
72 declare the convention used on that platform, if it's possible to
73 do so.
74
75 If this is the case for your platform, please file a bug report
76 with information on how to identify your platform via the C
77 pre-processor and how to specify the same calling convention as the
78 platform's malloc() implementation.
79*/
Benjamin Peterson4e211002018-06-26 19:25:45 -070080# define XMLCALL
81# endif
Fred Drake31d485c2004-08-03 07:06:22 +000082#endif /* not defined XMLCALL */
83
84
85#if !defined(XML_STATIC) && !defined(XMLIMPORT)
Benjamin Peterson4e211002018-06-26 19:25:45 -070086# ifndef XML_BUILDING_EXPAT
Fred Drake31d485c2004-08-03 07:06:22 +000087/* using Expat from an application */
88
Benjamin Peterson4e211002018-06-26 19:25:45 -070089# ifdef XML_USE_MSC_EXTENSIONS
90# define XMLIMPORT __declspec(dllimport)
91# endif
Fred Drake31d485c2004-08-03 07:06:22 +000092
Benjamin Peterson4e211002018-06-26 19:25:45 -070093# endif
Fred Drake31d485c2004-08-03 07:06:22 +000094#endif /* not defined XML_STATIC */
95
Benjamin Peterson3b03b092019-06-27 20:54:44 -070096#ifndef XML_ENABLE_VISIBILITY
97# define XML_ENABLE_VISIBILITY 0
98#endif
99
100#if !defined(XMLIMPORT) && XML_ENABLE_VISIBILITY
Benjamin Peterson4e211002018-06-26 19:25:45 -0700101# define XMLIMPORT __attribute__ ((visibility ("default")))
Victor Stinner23ec4b52017-06-15 00:54:36 +0200102#endif
Thomas Wouters0e3f5912006-08-11 14:57:12 +0000103
Fred Drake31d485c2004-08-03 07:06:22 +0000104/* If we didn't define it above, define it away: */
105#ifndef XMLIMPORT
Benjamin Peterson4e211002018-06-26 19:25:45 -0700106# define XMLIMPORT
Fred Drake31d485c2004-08-03 07:06:22 +0000107#endif
108
Victor Stinner23ec4b52017-06-15 00:54:36 +0200109#if defined(__GNUC__) && (__GNUC__ > 2 || (__GNUC__ == 2 && __GNUC_MINOR__ >= 96))
Benjamin Peterson4e211002018-06-26 19:25:45 -0700110# define XML_ATTR_MALLOC __attribute__((__malloc__))
Victor Stinner23ec4b52017-06-15 00:54:36 +0200111#else
Benjamin Peterson4e211002018-06-26 19:25:45 -0700112# define XML_ATTR_MALLOC
Victor Stinner23ec4b52017-06-15 00:54:36 +0200113#endif
114
115#if defined(__GNUC__) && ((__GNUC__ > 4) || (__GNUC__ == 4 && __GNUC_MINOR__ >= 3))
Benjamin Peterson4e211002018-06-26 19:25:45 -0700116# define XML_ATTR_ALLOC_SIZE(x) __attribute__((__alloc_size__(x)))
Victor Stinner23ec4b52017-06-15 00:54:36 +0200117#else
Benjamin Peterson4e211002018-06-26 19:25:45 -0700118# define XML_ATTR_ALLOC_SIZE(x)
Victor Stinner23ec4b52017-06-15 00:54:36 +0200119#endif
Fred Drake31d485c2004-08-03 07:06:22 +0000120
121#define XMLPARSEAPI(type) XMLIMPORT type XMLCALL
122
123#ifdef __cplusplus
124extern "C" {
125#endif
126
127#ifdef XML_UNICODE_WCHAR_T
Benjamin Peterson4e211002018-06-26 19:25:45 -0700128# ifndef XML_UNICODE
129# define XML_UNICODE
130# endif
Victor Stinner5ff71322017-06-21 14:39:22 +0200131# if defined(__SIZEOF_WCHAR_T__) && (__SIZEOF_WCHAR_T__ != 2)
132# error "sizeof(wchar_t) != 2; Need -fshort-wchar for both Expat and libc"
133# endif
Fred Drake31d485c2004-08-03 07:06:22 +0000134#endif
135
136#ifdef XML_UNICODE /* Information is UTF-16 encoded. */
Benjamin Peterson4e211002018-06-26 19:25:45 -0700137# ifdef XML_UNICODE_WCHAR_T
Fred Drake31d485c2004-08-03 07:06:22 +0000138typedef wchar_t XML_Char;
139typedef wchar_t XML_LChar;
Benjamin Peterson4e211002018-06-26 19:25:45 -0700140# else
Fred Drake31d485c2004-08-03 07:06:22 +0000141typedef unsigned short XML_Char;
142typedef char XML_LChar;
Benjamin Peterson4e211002018-06-26 19:25:45 -0700143# endif /* XML_UNICODE_WCHAR_T */
Fred Drake31d485c2004-08-03 07:06:22 +0000144#else /* Information is UTF-8 encoded. */
145typedef char XML_Char;
146typedef char XML_LChar;
147#endif /* XML_UNICODE */
Thomas Wouters0e3f5912006-08-11 14:57:12 +0000148
149#ifdef XML_LARGE_SIZE /* Use large integers for file/stream positions. */
Benjamin Peterson4e211002018-06-26 19:25:45 -0700150# if defined(XML_USE_MSC_EXTENSIONS) && _MSC_VER < 1400
Thomas Wouters0e3f5912006-08-11 14:57:12 +0000151typedef __int64 XML_Index;
152typedef unsigned __int64 XML_Size;
Benjamin Peterson4e211002018-06-26 19:25:45 -0700153# else
Thomas Wouters0e3f5912006-08-11 14:57:12 +0000154typedef long long XML_Index;
155typedef unsigned long long XML_Size;
Benjamin Peterson4e211002018-06-26 19:25:45 -0700156# endif
Thomas Wouters0e3f5912006-08-11 14:57:12 +0000157#else
158typedef long XML_Index;
159typedef unsigned long XML_Size;
160#endif /* XML_LARGE_SIZE */
161
162#ifdef __cplusplus
163}
164#endif
165
166#endif /* not Expat_External_INCLUDED */