kc3-lang/libxml2/include/libxml/globals.h

• Show log

  Commit

• Hash : db8b9722
  Author :
  Date : 2023-09-20T13:56:16
  

  parser: Deprecate global parser options
  
  Note that setting global options has no effect anyway when using any of
  the modern parser API functions which take an option argument like
  xmlReadMemory or when using xmlCtxtUseOptions.
  
  Global options only have an effect when using old API functions
  xmlParse* or xmlSAXParse* or when using an xmlParserCtxt without calling
  xmlCtxtUseOptions.
  
  Unfortunately, many downstream projects still modify global parser
  options often without realizing that it has no effect. If necessary,
  switch to the modern API. Then you can safely remove all code that
  changes global options.
  
  Here's a list of deprecated functions and global variables together with
  the corresponding parser options.
  
  - xmlSubstituteEntitiesDefault, xmlSubstituteEntitiesDefaultValue
    Parser option XML_PARSE_NOENT
  
  - xmlKeepBlanksDefault, xmlKeepBlanksDefaultValue
    Inverse of parser option XML_PARSE_NOBLANKS
  
  - xmlPedanticParserDefault, xmlPedanticParserDefaultValue
    Parser option XML_PARSE_PEDANTIC
  
  - xmlLineNumbersDefault, xmlLineNumbersDefaultValue
    Always enabled by new API
  
  - xmlDoValidityCheckingDefaultValue
    Parser option XML_PARSE_DTDVALID
  
  - xmlGetWarningsDefaultValue
    Inverse of parser option XML_PARSE_NOWARNING
  
  - xmlLoadExtDtdDefaultValue
    Parser options XML_PARSE_DTDLOAD and XML_PARSE_DTDATTR
  

Download

• include/libxml/globals.h

• /*
   * Summary: interface for all global variables of the library
   * Description: all the global variables and thread handling for
   *              those variables is handled by this module.
   *
   * Copy: See Copyright for the status of this software.
   *
   * Author: Gary Pennington <Gary.Pennington@uk.sun.com>, Daniel Veillard
   */
  
  #ifndef __XML_GLOBALS_H
  #define __XML_GLOBALS_H
  
  #include <libxml/xmlversion.h>
  #include <libxml/parser.h>
  #include <libxml/xmlerror.h>
  #include <libxml/SAX2.h>
  #include <libxml/xmlmemory.h>
  
  #ifdef __cplusplus
  extern "C" {
  #endif
  
  typedef struct _xmlGlobalState xmlGlobalState;
  typedef xmlGlobalState *xmlGlobalStatePtr;
  
  XMLPUBFUN int
  xmlCheckThreadLocalStorage(void);
  
  XML_DEPRECATED XMLPUBFUN void
  xmlInitGlobals(void);
  XML_DEPRECATED XMLPUBFUN void
  xmlCleanupGlobals(void);
  XML_DEPRECATED XMLPUBFUN void
  xmlInitializeGlobalState(xmlGlobalStatePtr gs);
  XML_DEPRECATED XMLPUBFUN
  xmlGlobalStatePtr xmlGetGlobalState(void);
  
  XMLPUBFUN void
  xmlThrDefSetGenericErrorFunc(void *ctx, xmlGenericErrorFunc handler);
  XMLPUBFUN void
  xmlThrDefSetStructuredErrorFunc(void *ctx, xmlStructuredErrorFunc handler);
  XMLPUBFUN int
  xmlThrDefIndentTreeOutput(int v);
  XMLPUBFUN const char *
  xmlThrDefTreeIndentString(const char * v);
  XMLPUBFUN int
  xmlThrDefSaveNoEmptyTags(int v);
  XML_DEPRECATED XMLPUBFUN xmlBufferAllocationScheme
  xmlThrDefBufferAllocScheme(xmlBufferAllocationScheme v);
  XML_DEPRECATED XMLPUBFUN int
  xmlThrDefDefaultBufferSize(int v);
  XML_DEPRECATED XMLPUBFUN int
  xmlThrDefDoValidityCheckingDefaultValue(int v);
  XML_DEPRECATED XMLPUBFUN int
  xmlThrDefGetWarningsDefaultValue(int v);
  XML_DEPRECATED XMLPUBFUN int
  xmlThrDefKeepBlanksDefaultValue(int v);
  XML_DEPRECATED XMLPUBFUN int
  xmlThrDefLineNumbersDefaultValue(int v);
  XML_DEPRECATED XMLPUBFUN int
  xmlThrDefLoadExtDtdDefaultValue(int v);
  XML_DEPRECATED XMLPUBFUN int
  xmlThrDefParserDebugEntities(int v);
  XML_DEPRECATED XMLPUBFUN int
  xmlThrDefPedanticParserDefaultValue(int v);
  XML_DEPRECATED XMLPUBFUN int
  xmlThrDefSubstituteEntitiesDefaultValue(int v);
  XMLPUBFUN xmlRegisterNodeFunc
  xmlThrDefRegisterNodeDefault(xmlRegisterNodeFunc func);
  XMLPUBFUN xmlDeregisterNodeFunc
  xmlThrDefDeregisterNodeDefault(xmlDeregisterNodeFunc func);
  XMLPUBFUN xmlOutputBufferCreateFilenameFunc
  xmlThrDefOutputBufferCreateFilenameDefault(xmlOutputBufferCreateFilenameFunc func);
  XMLPUBFUN xmlParserInputBufferCreateFilenameFunc
  xmlThrDefParserInputBufferCreateFilenameDefault(
          xmlParserInputBufferCreateFilenameFunc func);
  
  /** DOC_DISABLE */
  #if defined(LIBXML_THREAD_ENABLED) && defined(_WIN32) && \
      defined(LIBXML_STATIC_FOR_DLL)
  int
  xmlDllMain(void *hinstDLL, unsigned long fdwReason,
             void *lpvReserved);
  #endif
  /** DOC_ENABLE */
  
  /* Declare globals with macro magic */
  
  #define XML_EMPTY
  
  #define XML_GLOBALS_CORE \
    XML_OP(xmlLastError, xmlError, XML_EMPTY) \
    XML_OP(xmlGenericError, xmlGenericErrorFunc, XML_EMPTY) \
    XML_OP(xmlGenericErrorContext, void *, XML_EMPTY) \
    XML_OP(xmlStructuredError, xmlStructuredErrorFunc, XML_EMPTY) \
    XML_OP(xmlStructuredErrorContext, void *, XML_EMPTY) \
    XML_OP(xmlParserVersion, const char *, XML_EMPTY) \
    /* output options */ \
    XML_OP(xmlIndentTreeOutput, int, XML_EMPTY) \
    XML_OP(xmlTreeIndentString, const char *, XML_EMPTY) \
    XML_OP(xmlSaveNoEmptyTags, int, XML_EMPTY) \
    /* deprecated */ \
    XML_OP(oldXMLWDcompatibility, int, XML_DEPRECATED) \
    XML_OP(xmlBufferAllocScheme, xmlBufferAllocationScheme, XML_DEPRECATED) \
    XML_OP(xmlDefaultBufferSize, int, XML_DEPRECATED) \
    XML_OP(xmlDefaultSAXHandler, xmlSAXHandlerV1, XML_DEPRECATED) \
    XML_OP(xmlDefaultSAXLocator, xmlSAXLocator, XML_DEPRECATED) \
    XML_OP(xmlDoValidityCheckingDefaultValue, int, XML_DEPRECATED) \
    XML_OP(xmlGetWarningsDefaultValue, int, XML_DEPRECATED) \
    XML_OP(xmlKeepBlanksDefaultValue, int, XML_DEPRECATED) \
    XML_OP(xmlLineNumbersDefaultValue, int, XML_DEPRECATED) \
    XML_OP(xmlLoadExtDtdDefaultValue, int, XML_DEPRECATED) \
    XML_OP(xmlParserDebugEntities, int, XML_DEPRECATED) \
    XML_OP(xmlPedanticParserDefaultValue, int, XML_DEPRECATED) \
    XML_OP(xmlSubstituteEntitiesDefaultValue, int, XML_DEPRECATED) \
    XML_OP(xmlRegisterNodeDefaultValue, xmlRegisterNodeFunc, XML_DEPRECATED) \
    XML_OP(xmlDeregisterNodeDefaultValue, xmlDeregisterNodeFunc, \
             XML_DEPRECATED) \
    XML_OP(xmlParserInputBufferCreateFilenameValue, \
             xmlParserInputBufferCreateFilenameFunc, XML_DEPRECATED) \
    XML_OP(xmlOutputBufferCreateFilenameValue, \
             xmlOutputBufferCreateFilenameFunc, XML_DEPRECATED)
  
  #ifdef LIBXML_HTML_ENABLED
    #define XML_GLOBALS_HTML \
      XML_OP(htmlDefaultSAXHandler, xmlSAXHandlerV1, XML_DEPRECATED)
  #else
    #define XML_GLOBALS_HTML
  #endif
  
  /*
   * In general the memory allocation entry points are not kept
   * thread specific but this can be overridden by LIBXML_THREAD_ALLOC_ENABLED
   *    - xmlMalloc
   *    - xmlMallocAtomic
   *    - xmlRealloc
   *    - xmlMemStrdup
   *    - xmlFree
   */
  #ifdef LIBXML_THREAD_ALLOC_ENABLED
    #define XML_GLOBALS_ALLOC \
      XML_OP(xmlMalloc, xmlMallocFunc, XML_EMPTY) \
      XML_OP(xmlMallocAtomic, xmlMallocFunc, XML_EMPTY) \
      XML_OP(xmlRealloc, xmlReallocFunc, XML_EMPTY) \
      XML_OP(xmlFree, xmlFreeFunc, XML_EMPTY) \
      XML_OP(xmlMemStrdup, xmlStrdupFunc, XML_EMPTY)
  #else
    #define XML_GLOBALS_ALLOC
  
    XMLPUBVAR xmlMallocFunc xmlMalloc;
    XMLPUBVAR xmlMallocFunc xmlMallocAtomic;
    XMLPUBVAR xmlReallocFunc xmlRealloc;
    XMLPUBVAR xmlFreeFunc xmlFree;
    XMLPUBVAR xmlStrdupFunc xmlMemStrdup;
  #endif
  
  #define XML_GLOBALS \
    XML_GLOBALS_CORE \
    XML_GLOBALS_HTML \
    XML_GLOBALS_ALLOC
  
  #ifdef LIBXML_THREAD_ENABLED
    #define XML_DECLARE_GLOBAL(name, type, attrs) \
      attrs XMLPUBFUN type *__##name(void);
  #else
    #define XML_DECLARE_GLOBAL(name, type, attrs) \
      attrs XMLPUBVAR type name;
  #endif
  
  #define XML_OP XML_DECLARE_GLOBAL
  XML_GLOBALS
  #undef XML_OP
  
  #if defined(LIBXML_THREAD_ENABLED) && !defined(XML_GLOBALS_NO_REDEFINITION)
    #define XML_GLOBAL_MACRO(name) (*__##name())
  
    #define xmlLastError XML_GLOBAL_MACRO(xmlLastError)
    #define oldXMLWDcompatibility XML_GLOBAL_MACRO(oldXMLWDcompatibility)
    #define xmlBufferAllocScheme XML_GLOBAL_MACRO(xmlBufferAllocScheme)
    #define xmlDefaultBufferSize XML_GLOBAL_MACRO(xmlDefaultBufferSize)
    #define xmlDefaultSAXHandler XML_GLOBAL_MACRO(xmlDefaultSAXHandler)
    #define xmlDefaultSAXLocator XML_GLOBAL_MACRO(xmlDefaultSAXLocator)
    #define xmlDoValidityCheckingDefaultValue \
      XML_GLOBAL_MACRO(xmlDoValidityCheckingDefaultValue)
    #define xmlGenericError XML_GLOBAL_MACRO(xmlGenericError)
    #define xmlStructuredError XML_GLOBAL_MACRO(xmlStructuredError)
    #define xmlGenericErrorContext XML_GLOBAL_MACRO(xmlGenericErrorContext)
    #define xmlStructuredErrorContext XML_GLOBAL_MACRO(xmlStructuredErrorContext)
    #define xmlGetWarningsDefaultValue \
      XML_GLOBAL_MACRO(xmlGetWarningsDefaultValue)
    #define xmlIndentTreeOutput XML_GLOBAL_MACRO(xmlIndentTreeOutput)
    #define xmlTreeIndentString XML_GLOBAL_MACRO(xmlTreeIndentString)
    #define xmlKeepBlanksDefaultValue XML_GLOBAL_MACRO(xmlKeepBlanksDefaultValue)
    #define xmlLineNumbersDefaultValue \
      XML_GLOBAL_MACRO(xmlLineNumbersDefaultValue)
    #define xmlLoadExtDtdDefaultValue XML_GLOBAL_MACRO(xmlLoadExtDtdDefaultValue)
    #define xmlParserDebugEntities XML_GLOBAL_MACRO(xmlParserDebugEntities)
    #define xmlParserVersion XML_GLOBAL_MACRO(xmlParserVersion)
    #define xmlPedanticParserDefaultValue \
      XML_GLOBAL_MACRO(xmlPedanticParserDefaultValue)
    #define xmlSaveNoEmptyTags XML_GLOBAL_MACRO(xmlSaveNoEmptyTags)
    #define xmlSubstituteEntitiesDefaultValue \
      XML_GLOBAL_MACRO(xmlSubstituteEntitiesDefaultValue)
    #define xmlRegisterNodeDefaultValue \
      XML_GLOBAL_MACRO(xmlRegisterNodeDefaultValue)
    #define xmlDeregisterNodeDefaultValue \
      XML_GLOBAL_MACRO(xmlDeregisterNodeDefaultValue)
    #define xmlParserInputBufferCreateFilenameValue \
      XML_GLOBAL_MACRO(xmlParserInputBufferCreateFilenameValue)
    #define xmlOutputBufferCreateFilenameValue \
      XML_GLOBAL_MACRO(xmlOutputBufferCreateFilenameValue)
  
    #ifdef LIBXML_HTML_ENABLED
      #define htmlDefaultSAXHandler XML_GLOBAL_MACRO(htmlDefaultSAXHandler)
    #endif
  
    #ifdef LIBXML_THREAD_ALLOC_ENABLED
      #define xmlMalloc XML_GLOBAL_MACRO(xmlMalloc)
      #define xmlMallocAtomic XML_GLOBAL_MACRO(xmlMallocAtomic)
      #define xmlRealloc XML_GLOBAL_MACRO(xmlRealloc)
      #define xmlFree XML_GLOBAL_MACRO(xmlFree)
      #define xmlMemStrdup XML_GLOBAL_MACRO(xmlMemStrdup)
    #endif
  #endif
  
  #ifdef __cplusplus
  }
  #endif
  
  #endif /* __XML_GLOBALS_H */
  

Download