Home | Namespaces | Hierarchy | Alphabetical List | Class list | Files | Namespace Members | Class members | File members | Tutorials |
Interface providing easy read access to a XML file. More...
#include <irrXML.h>
Public Member Functions | |
virtual unsigned int | getAttributeCount () const =0 |
Returns attribute count of the current XML node. | |
virtual const char_type * | getAttributeName (int idx) const =0 |
Returns name of an attribute. | |
virtual const char_type * | getAttributeValue (const char_type *name) const =0 |
Returns the value of an attribute. | |
virtual const char_type * | getAttributeValue (int idx) const =0 |
Returns the value of an attribute. | |
virtual float | getAttributeValueAsFloat (int idx) const =0 |
Returns the value of an attribute as float. | |
virtual float | getAttributeValueAsFloat (const char_type *name) const =0 |
Returns the value of an attribute as float. | |
virtual int | getAttributeValueAsInt (int idx) const =0 |
Returns the value of an attribute as integer. | |
virtual int | getAttributeValueAsInt (const char_type *name) const =0 |
Returns the value of an attribute as integer. | |
virtual const char_type * | getAttributeValueSafe (const char_type *name) const =0 |
Returns the value of an attribute in a safe way. | |
virtual const char_type * | getNodeData () const =0 |
Returns data of the current node. | |
virtual const char_type * | getNodeName () const =0 |
Returns the name of the current node. | |
virtual EXML_NODE | getNodeType () const =0 |
Returns the type of the current XML node. | |
virtual ETEXT_FORMAT | getParserFormat () const =0 |
Returns format of the strings returned by the parser. | |
virtual ETEXT_FORMAT | getSourceFormat () const =0 |
Returns format of the source xml file. | |
virtual bool | isEmptyElement () const =0 |
Returns if an element is an empty element, like <foo />. | |
virtual bool | read ()=0 |
Reads forward to the next xml node. | |
virtual | ~IIrrXMLReader () |
Destructor. |
Interface providing easy read access to a XML file.
You can create an instance of this reader using one of the factory functions createIrrXMLReader(), createIrrXMLReaderUTF16() and createIrrXMLReaderUTF32(). If using the parser from the Irrlicht Engine, please use IFileSystem::createXMLReader() instead. For a detailed intro how to use the parser, see irrxmlexample and features.
The typical usage of this parser looks like this:
#include <irrXML.h> using namespace irr; // irrXML is located in the namespace irr::io using namespace io; void main() { // create the reader using one of the factory functions IrrXMLReader* xml = createIrrXMLReader("config.xml"); if (xml == 0) return; // file could not be opened // parse the file until end reached while(xml->read()) { // based on xml->getNodeType(), do something. } // delete the xml parser after usage delete xml; }
See irrxmlexample for a more detailed example.
Definition at line 274 of file irrXML.h.
virtual irr::io::IIrrXMLReader< char_type, super_class >::~IIrrXMLReader | ( | ) | [inline, virtual] |
virtual unsigned int irr::io::IIrrXMLReader< char_type, super_class >::getAttributeCount | ( | ) | const [pure virtual] |
Returns attribute count of the current XML node.
This is usually non null if the current node is EXN_ELEMENT, and the element has attributes.
virtual const char_type* irr::io::IIrrXMLReader< char_type, super_class >::getAttributeName | ( | int | idx | ) | const [pure virtual] |
Returns name of an attribute.
idx,: | Zero based index, should be something between 0 and getAttributeCount()-1. |
virtual const char_type* irr::io::IIrrXMLReader< char_type, super_class >::getAttributeValue | ( | const char_type * | name | ) | const [pure virtual] |
Returns the value of an attribute.
name,: | Name of the attribute. |
virtual const char_type* irr::io::IIrrXMLReader< char_type, super_class >::getAttributeValue | ( | int | idx | ) | const [pure virtual] |
Returns the value of an attribute.
idx,: | Zero based index, should be something between 0 and getAttributeCount()-1. |
virtual float irr::io::IIrrXMLReader< char_type, super_class >::getAttributeValueAsFloat | ( | int | idx | ) | const [pure virtual] |
Returns the value of an attribute as float.
idx,: | Zero based index, should be something between 0 and getAttributeCount()-1. |
virtual float irr::io::IIrrXMLReader< char_type, super_class >::getAttributeValueAsFloat | ( | const char_type * | name | ) | const [pure virtual] |
Returns the value of an attribute as float.
name,: | Name of the attribute. |
virtual int irr::io::IIrrXMLReader< char_type, super_class >::getAttributeValueAsInt | ( | int | idx | ) | const [pure virtual] |
Returns the value of an attribute as integer.
idx,: | Zero based index, should be something between 0 and getAttributeCount()-1. |
virtual int irr::io::IIrrXMLReader< char_type, super_class >::getAttributeValueAsInt | ( | const char_type * | name | ) | const [pure virtual] |
Returns the value of an attribute as integer.
name | Name of the attribute. |
virtual const char_type* irr::io::IIrrXMLReader< char_type, super_class >::getAttributeValueSafe | ( | const char_type * | name | ) | const [pure virtual] |
Returns the value of an attribute in a safe way.
Like getAttributeValue(), but does not return 0 if the attribute does not exist. An empty string ("") is returned then.
name,: | Name of the attribute. |
virtual const char_type* irr::io::IIrrXMLReader< char_type, super_class >::getNodeData | ( | ) | const [pure virtual] |
Returns data of the current node.
Only non null if the node has some data and it is of type EXN_TEXT or EXN_UNKNOWN.
virtual const char_type* irr::io::IIrrXMLReader< char_type, super_class >::getNodeName | ( | ) | const [pure virtual] |
Returns the name of the current node.
Only non null, if the node type is EXN_ELEMENT.
virtual EXML_NODE irr::io::IIrrXMLReader< char_type, super_class >::getNodeType | ( | ) | const [pure virtual] |
Returns the type of the current XML node.
virtual ETEXT_FORMAT irr::io::IIrrXMLReader< char_type, super_class >::getParserFormat | ( | ) | const [pure virtual] |
Returns format of the strings returned by the parser.
This will be UTF8 for example when you created a parser with IrrXMLReaderUTF8() and UTF32 when it has been created using IrrXMLReaderUTF32. It should not be necessary to call this method and only exists for informational purposes.
virtual ETEXT_FORMAT irr::io::IIrrXMLReader< char_type, super_class >::getSourceFormat | ( | ) | const [pure virtual] |
Returns format of the source xml file.
It is not necessary to use this method because the parser will convert the input file format to the format wanted by the user when creating the parser. This method is useful to get/display additional informations.
virtual bool irr::io::IIrrXMLReader< char_type, super_class >::isEmptyElement | ( | ) | const [pure virtual] |
Returns if an element is an empty element, like <foo />.
virtual bool irr::io::IIrrXMLReader< char_type, super_class >::read | ( | ) | [pure virtual] |
Reads forward to the next xml node.
The Irrlicht
Engine Documentation © 2003-2010 by Nikolaus Gebhardt. Generated
on Sun Oct 24 12:42:06 2010 by Doxygen
(1.6.2) |