cocos2d-x  3.0-alpha0
 All Classes Namespaces Files Functions Variables Typedefs Enumerations Enumerator Properties Friends Macros Groups Pages
XMLHandle Class Reference

A XMLHandle is a class that wraps a node pointer with null checks; this is an incredibly useful thing. More...

#include <tinyxml2.h>

Public Member Functions

 XMLHandle (XMLNode *node)
 Create a handle from any node (at any depth of the tree.) This can be a null pointer. More...
 
 XMLHandle (XMLNode &node)
 Create a handle from a node. More...
 
 XMLHandle (const XMLHandle &ref)
 Copy constructor. More...
 
XMLHandleoperator= (const XMLHandle &ref)
 Assignment. More...
 
XMLHandle FirstChild ()
 Get the first child of this handle. More...
 
XMLHandle FirstChildElement (const char *value=0)
 Get the first child element of this handle. More...
 
XMLHandle LastChild ()
 Get the last child of this handle. More...
 
XMLHandle LastChildElement (const char *_value=0)
 Get the last child element of this handle. More...
 
XMLHandle PreviousSibling ()
 Get the previous sibling of this handle. More...
 
XMLHandle PreviousSiblingElement (const char *_value=0)
 Get the previous sibling element of this handle. More...
 
XMLHandle NextSibling ()
 Get the next sibling of this handle. More...
 
XMLHandle NextSiblingElement (const char *_value=0)
 Get the next sibling element of this handle. More...
 
XMLNodeToNode ()
 Safe cast to XMLNode. This can return null. More...
 
XMLElementToElement ()
 Safe cast to XMLElement. This can return null. More...
 
XMLTextToText ()
 Safe cast to XMLText. This can return null. More...
 
XMLUnknownToUnknown ()
 Safe cast to XMLUnknown. This can return null. More...
 
XMLDeclarationToDeclaration ()
 Safe cast to XMLDeclaration. This can return null. More...
 

Detailed Description

A XMLHandle is a class that wraps a node pointer with null checks; this is an incredibly useful thing.

Note that XMLHandle is not part of the TinyXML DOM structure. It is a separate utility class.

Take an example:

<Document>
    <Element attributeA = "valueA">
        <Child attributeB = "value1" />
        <Child attributeB = "value2" />
    </Element>
</Document>

Assuming you want the value of "attributeB" in the 2nd "Child" element, it's very easy to write a lot of code that looks like:

XMLElement* root = document.FirstChildElement( "Document" );
if ( root )
{
    XMLElement* element = root->FirstChildElement( "Element" );
    if ( element )
    {
        XMLElement* child = element->FirstChildElement( "Child" );
        if ( child )
        {
            XMLElement* child2 = child->NextSiblingElement( "Child" );
            if ( child2 )
            {
                // Finally do something useful.

And that doesn't even cover "else" cases. XMLHandle addresses the verbosity of such code. A XMLHandle checks for null pointers so it is perfectly safe and correct to use:

XMLHandle docHandle( &document );
XMLElement* child2 = docHandle.FirstChild( "Document" ).FirstChild( "Element" ).FirstChild().NextSibling().ToElement();
if ( child2 )
{
    // do something useful

Which is MUCH more concise and useful.

It is also safe to copy handles - internally they are nothing more than node pointers.

XMLHandle handleCopy = handle;

See also XMLConstHandle, which is the same as XMLHandle, but operates on const objects.

Constructor & Destructor Documentation

XMLHandle ( XMLNode node)
inline

Create a handle from any node (at any depth of the tree.) This can be a null pointer.

XMLHandle ( XMLNode node)
inline

Create a handle from a node.

XMLHandle ( const XMLHandle ref)
inline

Copy constructor.

Member Function Documentation

XMLHandle FirstChild ( )
inline

Get the first child of this handle.

XMLHandle FirstChildElement ( const char *  value = 0)
inline

Get the first child element of this handle.

XMLHandle LastChild ( )
inline

Get the last child of this handle.

XMLHandle LastChildElement ( const char *  _value = 0)
inline

Get the last child element of this handle.

XMLHandle NextSibling ( )
inline

Get the next sibling of this handle.

XMLHandle NextSiblingElement ( const char *  _value = 0)
inline

Get the next sibling element of this handle.

XMLHandle& operator= ( const XMLHandle ref)
inline

Assignment.

XMLHandle PreviousSibling ( )
inline

Get the previous sibling of this handle.

XMLHandle PreviousSiblingElement ( const char *  _value = 0)
inline

Get the previous sibling element of this handle.

XMLDeclaration* ToDeclaration ( )
inline

Safe cast to XMLDeclaration. This can return null.

XMLElement* ToElement ( )
inline

Safe cast to XMLElement. This can return null.

XMLNode* ToNode ( )
inline

Safe cast to XMLNode. This can return null.

XMLText* ToText ( )
inline

Safe cast to XMLText. This can return null.

XMLUnknown* ToUnknown ( )
inline

Safe cast to XMLUnknown. This can return null.


The documentation for this class was generated from the following file: