#define __EASYXML_HXX
#include <simgear/compiler.h>
+#include <simgear/structure/exception.hxx>
-#include <simgear/misc/exception.hxx>
-
-#include STL_IOSTREAM
-#include STL_STRING
+#include <iostream>
+#include <string>
#include <vector>
-SG_USING_STD(istream);
-SG_USING_STD(string);
-SG_USING_STD(vector);
-
+typedef struct XML_ParserStruct* XML_Parser;
/**
* Interface for XML attributes.
virtual void setValue (const char * name, const char * value);
private:
- vector<string> _atts;
+ std::vector<std::string> _atts;
+};
+
+////////////////////////////////////////////////////////////////////////
+// Attribute list wrapper for Expat.
+////////////////////////////////////////////////////////////////////////
+
+class ExpatAtts : public XMLAttributes
+{
+public:
+ ExpatAtts (const char ** atts) : _atts(atts) {}
+
+ virtual int size () const;
+ virtual const char * getName (int i) const;
+ virtual const char * getValue (int i) const;
+
+ virtual const char * getValue (const char * name) const;
+private:
+ const char ** _atts;
};
class XMLVisitor
{
public:
+ /// Constructor
+ XMLVisitor() : parser(0), line(-1), column(-1) {}
/**
* Virtual destructor.
* the warning.
*/
virtual void warning (const char * message, int line, int column) {}
+
+ /** Set the path to the file that is parsed.
+ *
+ * This method will be called to store the path to the parsed file. Note that
+ * the XML parser makes no use of this copy of the path. The intent is
+ * to be capable of refering to the path to the parsed file if needed.
+ *
+ * @param _path The path to the parsed file.
+ * @see #getPath
+ */
+ void setPath(const std::string& _path) { path = _path; }
+
+ /** Get the path to the parsed file.
+ *
+ * This method will be called if the application needs to access the path to
+ * the parsed file. This information is typically needed if an error is found
+ * so the file where it occurred can be retrieved to help the user locate the
+ * error.
+ *
+ * @return the path to the parsed file.
+ * @see #setPath
+ */
+ const std::string& getPath(void) const { return path; }
+
+ /** Save the current position in the parsed file.
+ *
+ * This method will be called to save the position at which the file is
+ * currently parsed. Note that the XML parser makes no use of that
+ * information. The intent is to be capable of refering to the position in
+ * the parsed file if needed.
+ *
+ * @see #getColumn
+ * @see #getLine
+ */
+ void savePosition(void);
+
+ /** Get the saved column number in the parsed file.
+ *
+ * This method will be called if the application needs to get the column
+ * number that has been saved during the last call to savePosition(). This
+ * information is typically needed if an error is found so the position at
+ * which it occurred can be retrieved to help the user locate the error.
+ *
+ * @return the save column number.
+ * @see #savePosition
+ */
+ int getColumn(void) const { return column; }
+
+ /** Get the saved line number in the parsed file.
+ *
+ * This method will be called if the application needs to get the line
+ * number that has been saved during the last call to savePosition(). This
+ * information is typically needed if an error is found so the position at
+ * which it occurred can be retrieved to help the user locate the error.
+ *
+ * @return the save line number.
+ * @see #savePosition
+ */
+ int getLine(void) const { return line; }
+
+ /** Set the XML parser.
+ *
+ * This method will be called so the #XMLVisitor instance can internally use
+ * the XML parser for its housekeeping. The intent is that #XMLVisitor will
+ * only call the reporting functions of the XML parser and will not interfer
+ * with the XML parser current state. Doing otherwise will result in an
+ * unpredictable behavior of the XML parser.
+ *
+ * @param _parser the XML parser
+ */
+ void setParser(XML_Parser _parser) { parser = _parser; }
+private:
+ XML_Parser parser;
+ std::string path;
+ int line, column;
};
* is a problem reading the file.
* @see XMLVisitor
*/
-extern void readXML (istream &input, XMLVisitor &visitor,
- const string &path="");
+extern void readXML (std::istream &input, XMLVisitor &visitor,
+ const std::string &path="");
/**
* is a problem reading the file.
* @see XMLVisitor
*/
-extern void readXML (const string &path, XMLVisitor &visitor);
+extern void readXML (const std::string &path, XMLVisitor &visitor);
+
+
+/**
+ * @relates XMLVisitor
+ * Read an XML document.
+ *
+ * This function reads an XML document from the buffer provided,
+ * and invokes the callback methods in the visitor object to pass the
+ * parsing events back to the application. When this function
+ * returns, the parser will have reported all of the data in the XML
+ * document to the application through the visitor callback methods,
+ * and XML processing will be complete.
+ *
+ * @param buf The xml data buffer.
+ * @param size The size of the data buffer in bytes
+ * @param visitor An object that contains callbacks for XML parsing
+ * events.
+ * @exception Throws sg_io_exception or sg_xml_exception if there
+ * is a problem reading the file.
+ * @see XMLVisitor
+ */
+extern void readXML (const char *buf, const int size, XMLVisitor &visitor);
#endif // __EASYXML_HXX