Analysis Software
Documentation for sPHENIX simulation software
|
#include <JETSCAPE/blob/main/external_packages/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. | |
XMLHandle (XMLNode &node) | |
Create a handle from a node. | |
XMLHandle (const XMLHandle &ref) | |
Copy constructor. | |
XMLHandle & | operator= (const XMLHandle &ref) |
Assignment. | |
XMLHandle | FirstChild () |
Get the first child of this handle. | |
XMLHandle | FirstChildElement (const char *name=0) |
Get the first child element of this handle. | |
XMLHandle | LastChild () |
Get the last child of this handle. | |
XMLHandle | LastChildElement (const char *name=0) |
Get the last child element of this handle. | |
XMLHandle | PreviousSibling () |
Get the previous sibling of this handle. | |
XMLHandle | PreviousSiblingElement (const char *name=0) |
Get the previous sibling element of this handle. | |
XMLHandle | NextSibling () |
Get the next sibling of this handle. | |
XMLHandle | NextSiblingElement (const char *name=0) |
Get the next sibling element of this handle. | |
XMLNode * | ToNode () |
Safe cast to XMLNode. This can return null. | |
XMLElement * | ToElement () |
Safe cast to XMLElement. This can return null. | |
XMLText * | ToText () |
Safe cast to XMLText. This can return null. | |
XMLUnknown * | ToUnknown () |
Safe cast to XMLUnknown. This can return null. | |
XMLDeclaration * | ToDeclaration () |
Safe cast to XMLDeclaration. This can return null. | |
Private Attributes | |
XMLNode * | _node |
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-2 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.FirstChildElement( "Document" ).FirstChildElement( "Element" ).FirstChildElement().NextSiblingElement(); 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.
Definition at line 1860 of file tinyxml2.h.
View newest version in sPHENIX GitHub at line 1860 of file tinyxml2.h
|
inline |
Create a handle from any node (at any depth of the tree.) This can be a null pointer.
Definition at line 1864 of file tinyxml2.h.
View newest version in sPHENIX GitHub at line 1864 of file tinyxml2.h
|
inline |
Create a handle from a node.
Definition at line 1868 of file tinyxml2.h.
View newest version in sPHENIX GitHub at line 1868 of file tinyxml2.h
|
inline |
Copy constructor.
Definition at line 1872 of file tinyxml2.h.
View newest version in sPHENIX GitHub at line 1872 of file tinyxml2.h
References _node.
|
inline |
Get the first child of this handle.
Definition at line 1882 of file tinyxml2.h.
View newest version in sPHENIX GitHub at line 1882 of file tinyxml2.h
|
inline |
Get the first child element of this handle.
Definition at line 1886 of file tinyxml2.h.
View newest version in sPHENIX GitHub at line 1886 of file tinyxml2.h
References perf_headwind::name.
|
inline |
Get the last child of this handle.
Definition at line 1890 of file tinyxml2.h.
View newest version in sPHENIX GitHub at line 1890 of file tinyxml2.h
|
inline |
Get the last child element of this handle.
Definition at line 1894 of file tinyxml2.h.
View newest version in sPHENIX GitHub at line 1894 of file tinyxml2.h
References perf_headwind::name.
|
inline |
Get the next sibling of this handle.
Definition at line 1906 of file tinyxml2.h.
View newest version in sPHENIX GitHub at line 1906 of file tinyxml2.h
|
inline |
Get the next sibling element of this handle.
Definition at line 1910 of file tinyxml2.h.
View newest version in sPHENIX GitHub at line 1910 of file tinyxml2.h
References perf_headwind::name.
Assignment.
Definition at line 1876 of file tinyxml2.h.
View newest version in sPHENIX GitHub at line 1876 of file tinyxml2.h
References _node.
|
inline |
Get the previous sibling of this handle.
Definition at line 1898 of file tinyxml2.h.
View newest version in sPHENIX GitHub at line 1898 of file tinyxml2.h
|
inline |
Get the previous sibling element of this handle.
Definition at line 1902 of file tinyxml2.h.
View newest version in sPHENIX GitHub at line 1902 of file tinyxml2.h
References perf_headwind::name.
|
inline |
Safe cast to XMLDeclaration. This can return null.
Definition at line 1931 of file tinyxml2.h.
View newest version in sPHENIX GitHub at line 1931 of file tinyxml2.h
|
inline |
Safe cast to XMLElement. This can return null.
Definition at line 1919 of file tinyxml2.h.
View newest version in sPHENIX GitHub at line 1919 of file tinyxml2.h
|
inline |
Safe cast to XMLNode. This can return null.
Definition at line 1915 of file tinyxml2.h.
View newest version in sPHENIX GitHub at line 1915 of file tinyxml2.h
|
inline |
Safe cast to XMLText. This can return null.
Definition at line 1923 of file tinyxml2.h.
View newest version in sPHENIX GitHub at line 1923 of file tinyxml2.h
|
inline |
Safe cast to XMLUnknown. This can return null.
Definition at line 1927 of file tinyxml2.h.
View newest version in sPHENIX GitHub at line 1927 of file tinyxml2.h
|
private |
Definition at line 1936 of file tinyxml2.h.
View newest version in sPHENIX GitHub at line 1936 of file tinyxml2.h
Referenced by operator=(), and XMLHandle().