llxmlparser.h
上传用户:king477883
上传日期:2021-03-01
资源大小:9553k
文件大小:5k
源码类别:

游戏引擎

开发平台:

C++ Builder

  1. /** 
  2.  * @file llxmlparser.h
  3.  * @brief LLXmlParser class definition
  4.  *
  5.  * $LicenseInfo:firstyear=2002&license=viewergpl$
  6.  * 
  7.  * Copyright (c) 2002-2010, Linden Research, Inc.
  8.  * 
  9.  * Second Life Viewer Source Code
  10.  * The source code in this file ("Source Code") is provided by Linden Lab
  11.  * to you under the terms of the GNU General Public License, version 2.0
  12.  * ("GPL"), unless you have obtained a separate licensing agreement
  13.  * ("Other License"), formally executed by you and Linden Lab.  Terms of
  14.  * the GPL can be found in doc/GPL-license.txt in this distribution, or
  15.  * online at http://secondlifegrid.net/programs/open_source/licensing/gplv2
  16.  * 
  17.  * There are special exceptions to the terms and conditions of the GPL as
  18.  * it is applied to this Source Code. View the full text of the exception
  19.  * in the file doc/FLOSS-exception.txt in this software distribution, or
  20.  * online at
  21.  * http://secondlifegrid.net/programs/open_source/licensing/flossexception
  22.  * 
  23.  * By copying, modifying or distributing this software, you acknowledge
  24.  * that you have read and understood your obligations described above,
  25.  * and agree to abide by those obligations.
  26.  * 
  27.  * ALL LINDEN LAB SOURCE CODE IS PROVIDED "AS IS." LINDEN LAB MAKES NO
  28.  * WARRANTIES, EXPRESS, IMPLIED OR OTHERWISE, REGARDING ITS ACCURACY,
  29.  * COMPLETENESS OR PERFORMANCE.
  30.  * $/LicenseInfo$
  31.  */
  32. #ifndef LL_LLXMLPARSER_H
  33. #define LL_LLXMLPARSER_H
  34. #ifndef XML_STATIC
  35. #define XML_STATIC
  36. #endif
  37. #ifdef LL_STANDALONE
  38. #include <expat.h>
  39. #else
  40. #include "expat/expat.h"
  41. #endif
  42. class LLXmlParser
  43. {
  44. public:
  45. LLXmlParser();
  46. virtual ~LLXmlParser();
  47. // Parses entire file
  48. BOOL parseFile(const std::string &path);
  49. // Parses some input. Returns 0 if a fatal error is detected.
  50. // The last call must have isFinal true;
  51. // len may be zero for this call (or any other).
  52. S32 parse( const char* buf, int len, int isFinal );
  53. const char* getErrorString();
  54. S32 getCurrentLineNumber();
  55. S32 getCurrentColumnNumber();
  56. S32 getDepth() { return mDepth; }
  57. protected:
  58. // atts is array of name/value pairs, terminated by 0;
  59. // names and values are 0 terminated.
  60. virtual void startElement(const char *name, const char **atts) {}
  61. virtual void endElement(const char *name) {}
  62. // s is not 0 terminated.
  63. virtual void characterData(const char *s, int len) {}
  64. // target and data are 0 terminated
  65. virtual void processingInstruction(const char *target, const char *data) {}
  66. // data is 0 terminated 
  67. virtual void comment(const char *data) {}
  68. virtual void startCdataSection() {}
  69. virtual void endCdataSection() {}
  70. // This is called for any characters in the XML document for
  71. // which there is no applicable handler.  This includes both
  72. // characters that are part of markup which is of a kind that is
  73. // not reported (comments, markup declarations), or characters
  74. // that are part of a construct which could be reported but
  75. // for which no handler has been supplied. The characters are passed
  76. // exactly as they were in the XML document except that
  77. // they will be encoded in UTF-8.  Line boundaries are not normalized.
  78. // Note that a byte order mark character is not passed to the default handler.
  79. // There are no guarantees about how characters are divided between calls
  80. // to the default handler: for example, a comment might be split between
  81. // multiple calls.
  82. virtual void defaultData(const char *s, int len) {}
  83. // This is called for a declaration of an unparsed (NDATA)
  84. // entity.  The base argument is whatever was set by XML_SetBase.
  85. // The entityName, systemId and notationName arguments will never be null.
  86. // The other arguments may be.
  87. virtual void unparsedEntityDecl(
  88. const char *entityName,
  89. const char *base,
  90. const char *systemId,
  91. const char *publicId,
  92. const char *notationName) {}
  93. public:
  94. ///////////////////////////////////////////////////////////////////////////////
  95. // Pseudo-private methods.  These are only used by internal callbacks.
  96. static void startElementHandler(void *userData, const XML_Char *name, const XML_Char **atts);
  97. static void endElementHandler(void *userData, const XML_Char *name);
  98. static void characterDataHandler(void *userData, const XML_Char *s, int len);
  99. static void processingInstructionHandler(void *userData, const XML_Char *target, const XML_Char *data);
  100. static void commentHandler(void *userData, const XML_Char *data);
  101. static void startCdataSectionHandler(void *userData);
  102. static void endCdataSectionHandler(void *userData);
  103. static void defaultDataHandler( void *userData, const XML_Char *s, int len);
  104. static void unparsedEntityDeclHandler(
  105. void *userData,
  106. const XML_Char *entityName,
  107. const XML_Char *base,
  108. const XML_Char *systemId,
  109. const XML_Char *publicId,
  110. const XML_Char *notationName);
  111. protected:
  112. XML_Parser mParser;
  113. int mDepth;
  114. std::string mAuxErrorString;
  115. };
  116. #endif  // LL_LLXMLPARSER_H