Line data    Source code

       1             : /******************************************************************************
       2             :  * $Id$
       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) ||                                             \
      51             :     (XML_MAJOR_VERSION * 10000 + XML_MINOR_VERSION * 100 +                     \
      52             :      XML_MICRO_VERSION) < 19508
      53             : #define XML_StopParser(parser, resumable)
      54             : #warning                                                                       \
      55             :     "Expat version is too old and does not have XML_StopParser. Corrupted files could hang OGR"
      56             : #endif
      57             : 
      58             : /* Only for internal use ! */
      59             : XML_Parser CPL_DLL OGRCreateExpatXMLParser(void);
      60             : 
      61             : //
      62             : //! @cond Doxygen_Suppress
      63             : struct CPL_DLL OGRExpatUniquePtrDeleter
      64             : {
      65         199 :     void operator()(XML_Parser oParser) const
      66             :     {
      67         199 :         XML_ParserFree(oParser);
      68         199 :     }
      69             : };
      70             : 
      71             : //! @endcond
      72             : 
      73             : /** Unique pointer type for XML_Parser.
      74             :  * @since GDAL 3.2
      75             :  */
      76             : using OGRExpatUniquePtr =
      77             :     std::unique_ptr<XML_ParserStruct, OGRExpatUniquePtrDeleter>;
      78             : 
      79             : #endif /* HAVE_EXPAT */
      80             : 
      81             : #endif /* OGR_EXPATH_INCLUDED */