1 /******************************************************************************
2  * $Id: ogr_expat.h 960e631de2d440c518307009ab6ac3cd599fd709 2020-06-02 11:51:16 +0200 Yorick de Wid $
3  *
4  * Project:  OGR
5  * Purpose:  Convenience function for parsing with Expat library
6  * Author:   Even Rouault, even dot rouault at spatialys.com
7  *
8  ******************************************************************************
9  * Copyright (c) 2009, Even Rouault <even dot rouault at spatialys.com>
10  *
11  * Permission is hereby granted, free of charge, to any person obtaining a
12  * copy of this software and associated documentation files (the "Software"),
13  * to deal in the Software without restriction, including without limitation
14  * the rights to use, copy, modify, merge, publish, distribute, sublicense,
15  * and/or sell copies of the Software, and to permit persons to whom the
16  * Software is furnished to do so, subject to the following conditions:
17  *
18  * The above copyright notice and this permission notice shall be included
19  * in all copies or substantial portions of the Software.
20  *
21  * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS
22  * OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
23  * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL
24  * THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
25  * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
26  * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER
27  * DEALINGS IN THE SOFTWARE.
28  ****************************************************************************/
29 
30 #ifndef OGR_EXPATH_INCLUDED
31 #define OGR_EXPATH_INCLUDED
32 
33 #ifdef HAVE_EXPAT
34 
35 #include "cpl_port.h"
36 #include <expat.h>
37 
38 #include <memory>
39 
40 /* Compatibility stuff for expat >= 1.95.0 and < 1.95.7 */
41 #ifndef XMLCALL
42 #define XMLCALL
43 #endif
44 #ifndef XML_STATUS_OK
45 #define XML_STATUS_OK    1
46 #define XML_STATUS_ERROR 0
47 #endif
48 
49 /* XML_StopParser only available for expat >= 1.95.8 */
50 #if !defined(XML_MAJOR_VERSION) || (XML_MAJOR_VERSION * 10000 + XML_MINOR_VERSION * 100 + XML_MICRO_VERSION) < 19508
51 #define XML_StopParser(parser, resumable)
52 #warning "Expat version is too old and does not have XML_StopParser. Corrupted files could hang OGR"
53 #endif
54 
55 /* Only for internal use ! */
56 XML_Parser CPL_DLL OGRCreateExpatXMLParser(void);
57 
58 //
59 //! @cond Doxygen_Suppress
60 struct CPL_DLL OGRExpatUniquePtrDeleter
61 {
operatorOGRExpatUniquePtrDeleter62     void operator()(XML_Parser oParser) const
63         { XML_ParserFree(oParser); }
64 };
65 //! @endcond
66 
67 /** Unique pointer type for XML_Parser.
68  * @since GDAL 3.2
69  */
70 using OGRExpatUniquePtr = std::unique_ptr<XML_ParserStruct, OGRExpatUniquePtrDeleter>;
71 
72 #endif /* HAVE_EXPAT */
73 
74 #endif /* OGR_EXPATH_INCLUDED */
75