Class XML_Node is a tree-based representation of the contents of an XML file. More...

#include <xml.h>

Collaboration diagram for XML_Node:

Public Member Functions
	XML_Node (const std::string &nm="--", XML_Node *const parent=0)
	Constructor for XML_Node, representing a tree structure. More...

	XML_Node (const XML_Node &right)

XML_Node &	operator= (const XML_Node &right)

void	addComment (const std::string &comment)
	Add a child node to the current node containing a comment. More...

XML_Node &	mergeAsChild (XML_Node &node)
	Merge an existing node as a child node to the current node. More...

XML_Node &	addChild (const XML_Node &node)

XML_Node &	addChild (const std::string &sname)
	Add a child node to the current node with a specified name. More...

XML_Node &	addChild (const std::string &name, const std::string &value)
	Add a child node to the current XML node, and at the same time add a value to the child. More...

XML_Node &	addChild (const std::string &name, const doublereal value, const std::string &fmt="%g")
	Add a child node to the current XML node, and at the same time add a formatted value to the child. More...

void	removeChild (const XML_Node *const node)
	Remove a child from this node's list of children. More...

void	addValue (const std::string &val)
	Modify the value for the current node. More...

void	addValue (const doublereal val, const std::string &fmt="%g")
	Modify the value for the current node. More...

std::string	value () const
	Return the value of an XML node as a string. More...

std::string	operator() () const
	Overloaded parenthesis operator returns the value of the Node. More...

std::string	value (const std::string &cname) const
	Return the value of an XML child node as a string. More...

std::string	operator() (const std::string &cname) const
	The Overloaded parenthesis operator with one augment returns the value of an XML child node as a string. More...

doublereal	fp_value () const
	Return the value of an XML node as a single double. More...

integer	int_value () const
	Return the value of an XML node as a single int. More...

void	addAttribute (const std::string &attrib, const std::string &value)
	Add or modify an attribute of the current node. More...

void	addAttribute (const std::string &attrib, const doublereal value, const std::string &fmt="%g")
	Add or modify an attribute to the double, value. More...

void	addAttribute (const std::string &attrib, int value)
	Add an integer attribute. More...

void	addAttribute (const std::string &attrib, size_t value)
	Add an unsigned integer attribute. More...

std::string	operator[] (const std::string &attr) const
	The operator[] is overloaded to provide a lookup capability on attributes for the current XML element. More...

std::string	attrib (const std::string &attr) const
	Function returns the value of an attribute. More...

void	clear ()
	Clear the current node and everything under it. More...

const std::map< std::string, std::string > &	attribsConst () const
	Returns an unchangeable value of the attributes map for the current node. More...

void	setLineNumber (const int n)
	Set the line number. More...

int	lineNumber () const
	Return the line number. More...

XML_Node *	parent () const
	Returns a pointer to the parent node of the current node. More...

XML_Node *	setParent (XML_Node *const p)
	Sets the pointer for the parent node of the current node. More...

bool	hasChild (const std::string &ch) const
	Tests whether the current node has a child node with a particular name. More...

bool	hasAttrib (const std::string &a) const
	Tests whether the current node has an attribute with a particular name. More...

std::string	name () const
	Returns the name of the XML node. More...

void	setName (const std::string &name_)
	Sets the name of the XML node. More...

std::string	id () const
	Return the id attribute, if present. More...

XML_Node &	child (const size_t n) const
	Return a changeable reference to the n'th child of the current node. More...

const std::vector< XML_Node * > &	children () const
	Return an unchangeable reference to the vector of children of the current node. More...

size_t	nChildren (bool discardComments=false) const
	Return the number of children. More...

bool	isComment () const
	Boolean function indicating whether a comment. More...

void	_require (const std::string &a, const std::string &v) const
	Require that the current XML node have an attribute named by the first argument, a, and that this attribute have the the string value listed in the second argument, v. More...

XML_Node *	findNameID (const std::string &nameTarget, const std::string &idTarget) const
	This routine carries out a recursive search for an XML node based on both the XML element name and the attribute ID. More...

XML_Node *	findNameIDIndex (const std::string &nameTarget, const std::string &idTarget, const int index) const
	This routine carries out a search for an XML node based on both the XML element name and the attribute ID and an integer index. More...

XML_Node *	findID (const std::string &id, const int depth=100) const
	This routine carries out a recursive search for an XML node based on the XML element attribute, "id". More...

XML_Node *	findByAttr (const std::string &attr, const std::string &val, int depth=100000) const
	This routine carries out a recursive search for an XML node based on an attribute of each XML node. More...

const XML_Node *	findByName (const std::string &nm, int depth=100000) const
	This routine carries out a recursive search for an XML node based on the name of the node. More...

XML_Node *	findByName (const std::string &nm, int depth=100000)
	This routine carries out a recursive search for an XML node based on the name of the node. More...

void	getChildren (const std::string &name, std::vector< XML_Node * > &children) const
	Get a vector of pointers to XML_Node containing all of the children of the current node which matches the input name. More...

std::vector< XML_Node * >	getChildren (const std::string &name) const
	Get a vector of pointers to XML_Node containing all of the children of the current node which match the given name. More...

XML_Node &	child (const std::string &loc) const
	Return a changeable reference to a child of the current node, named by the argument. More...

void	writeHeader (std::ostream &s)
	Write the header to the XML file to the specified ostream. More...

void	write (std::ostream &s, const int level=0, int numRecursivesAllowed=60000) const
	Write an XML subtree to an output stream. More...

XML_Node &	root () const
	Return the root of the current XML_Node tree. More...

void	setRoot (const XML_Node &root)
	Set the root XML_Node value within the current node. More...

void	build (std::istream &f)
	Main routine to create an tree-like representation of an XML file. More...

void	copyUnion (XML_Node *const node_dest) const
	Copy all of the information in the current XML_Node tree into the destination XML_Node tree, doing a union operation as we go. More...

void	copy (XML_Node *const node_dest) const
	Copy all of the information in the current XML_Node tree into the destination XML_Node tree, doing a complete copy as we go. More...

void	lock ()
	Set the lock for this node and all of its children. More...

void	unlock ()
	Unset the lock for this node and all of its children. More...

Protected Attributes
std::string	m_name
	XML node name of the node. More...

std::string	m_value
	Value of the XML node. More...

std::multimap< std::string, XML_Node * >	m_childindex
	Map containing an index between the node name and the pointer to the node. More...

std::map< std::string, std::string >	m_attribs
	Storage of attributes for a node. More...

XML_Node *	m_parent
	Pointer to the parent XML_Node for the current node. More...

XML_Node *	m_root
	Pointer to the root XML_Node for the current node. More...

bool	m_locked
	Lock for this node. More...

std::vector< XML_Node * >	m_children
	Vector of pointers to child nodes. More...

bool	m_iscomment
	True if the current node is a comment node. More...

int	m_linenum
	The member data m_linenum. More...

Private Member Functions
std::map< std::string, std::string > &	attribs ()
	Returns a changeable value of the attributes map for the current node. More...

void	write_int (std::ostream &s, int level=0, int numRecursivesAllowed=60000) const
	Write an XML subtree to an output stream. More...

Detailed Description

Class XML_Node is a tree-based representation of the contents of an XML file.

There are routines for adding to the tree, querying and searching the tree, and for writing the tree out to an output file.

Definition at line 100 of file xml.h.

Constructor & Destructor Documentation

XML_Node	(	const std::string &	nm = `"--"`,
		XML_Node *const	parent = `0`
	)

explicit

Constructor for XML_Node, representing a tree structure.

Parameters

nm	Name of the node.
parent	Pointer to the parent for this node in the tree. A value of 0 indicates this is the top of the tree.

Definition at line 321 of file xml.cpp.

References XML_Node::m_root, and XML_Node::root().

Referenced by XML_Node::addChild().

Member Function Documentation

void addComment ( const std::string & comment )

Add a child node to the current node containing a comment.

Child node will have the name, comment.

Parameters

comment Content of the comment

Definition at line 401 of file xml.cpp.

Referenced by XML_Node::build().

XML_Node & mergeAsChild ( XML_Node & node )

Merge an existing node as a child node to the current node.

This will merge an XML_Node as a child to the current node. Note, this actually adds the node. Therefore, the current node is changed. There is no copy made of the child node. The child node should not be deleted in the future

Parameters

node	Reference to a child XML_Node object

Returns: Returns a reference to the added child node

Definition at line 406 of file xml.cpp.

References XML_Node::m_childindex, XML_Node::m_children, XML_Node::name(), XML_Node::root(), XML_Node::setParent(), and XML_Node::setRoot().

Referenced by XML_Node::addChild().

XML_Node & addChild ( const std::string & sname )

Add a child node to the current node with a specified name.

This will add an XML_Node as a child to the current node. The node will be blank except for the specified name.

Parameters

sname Name of the new child

Returns: Returns a reference to the added node

Definition at line 420 of file xml.cpp.

References XML_Node::mergeAsChild(), and XML_Node::XML_Node().

XML_Node & addChild	(	const std::string &	name,
		const std::string &	value
	)

Add a child node to the current XML node, and at the same time add a value to the child.

Resulting XML string:

<name> value </name>

Parameters

name	Name of the child XML_Node object
value	Value of the XML_Node - string

Returns: Returns a reference to the created child XML_Node object

Definition at line 425 of file xml.cpp.

References XML_Node::addValue().

XML_Node & addChild	(	const std::string &	name,
		const doublereal	value,
		const std::string &	fmt = `"%g"`
	)

Add a child node to the current XML node, and at the same time add a formatted value to the child.

This version supplies a formatting string (printf format) to the output of the value.

Resulting XML string:

<name> value </name>

Parameters

name	Name of the child XML_Node object
value	Value of the XML_Node - double.
fmt	Format of the output for value

Returns: Returns a reference to the created child XML_Node object

Definition at line 432 of file xml.cpp.

References XML_Node::addValue().

void removeChild ( const XML_Node *const node )

Remove a child from this node's list of children.

This function removes an XML_Node from the children of this node.

Parameters

node	Pointer to the node to be removed. Note, this node isn't modified in any way.

Definition at line 440 of file xml.cpp.

References XML_Node::m_childindex, XML_Node::m_children, and XML_Node::name().

void addValue ( const std::string & val )

Modify the value for the current node.

This functions fills in the m_value field of the current node

Parameters

val	string Value that the node will be assigned

Definition at line 456 of file xml.cpp.

References XML_Node::m_iscomment, XML_Node::m_name, and XML_Node::m_value.

Referenced by XML_Node::addChild(), XML_Node::build(), XML_Node::copy(), and XML_Node::copyUnion().

void addValue	(	const doublereal	val,
		const std::string &	fmt = `"%g"`
	)

Modify the value for the current node.

This functions fills in the m_value field of the current node with a formatted double value

Parameters

val	double Value that the node will be assigned
fmt	Format of the printf string conversion of the double. Default is "%g". Must be less than 63 chars

Definition at line 464 of file xml.cpp.

References Cantera::fp2str(), XML_Node::m_value, and Cantera::stripws().

std::string value ( ) const

Return the value of an XML node as a string.

This is a simple accessor routine

Definition at line 469 of file xml.cpp.

References XML_Node::m_value.

Referenced by XML_Node::addAttribute(), Cantera::getFloatArray(), Cantera::getFloatCurrent(), Cantera::getInteger(), Cantera::getNamedStringValue(), Cantera::getString(), Cantera::getStringArray(), MaskellSolidSolnPhase::initThermoXML(), Cantera::newSpecies(), XML_Node::operator()(), HMWSoln::readXMLBinarySalt(), HMWSoln::readXMLPsiCommonAnion(), HMWSoln::readXMLPsiCommonCation(), StFlow::restore(), and XML_Node::value().

std::string operator() ( ) const

Overloaded parenthesis operator returns the value of the Node.

Returns: Returns the value of the node as a string.

Deprecated:: Use value() instead.

Definition at line 474 of file xml.cpp.

References XML_Node::m_value, and Cantera::warn_deprecated().

std::string value ( const std::string & cname ) const

Return the value of an XML child node as a string.

Parameters

cname Name of the child node to the current node, for which you want the value

Definition at line 491 of file xml.cpp.

References XML_Node::child(), and XML_Node::value().

std::string operator() ( const std::string & cname ) const

The Overloaded parenthesis operator with one augment returns the value of an XML child node as a string.

Parameters

cname Name of the child node to the current node, for which you want the value

Definition at line 496 of file xml.cpp.

References XML_Node::value().

doublereal fp_value ( ) const

Return the value of an XML node as a single double.

This accesses the value string, and then tries to interpret it as a single double value.

Definition at line 481 of file xml.cpp.

References Cantera::fpValueCheck(), and XML_Node::m_value.

Referenced by Cantera::getFloatCurrent(), Cantera::getReagents(), Inlet1D::restore(), OutletRes1D::restore(), and ReactingSurf1D::restore().

integer int_value ( ) const

Return the value of an XML node as a single int.

This accesses the value string, and then tries to interpret it as a single int value.

Definition at line 486 of file xml.cpp.

References XML_Node::m_value.

Referenced by Cantera::getInteger().

void addAttribute	(	const std::string &	attrib,
		const std::string &	value
	)

Add or modify an attribute of the current node.

This functions fills in the m_value field of the current node with a string value

Parameters

attrib	String name for the attribute to be assigned
value	String value that the attribute will have

Definition at line 501 of file xml.cpp.

References XML_Node::attrib(), XML_Node::m_attribs, and XML_Node::value().

Referenced by Cantera::addFloat(), Cantera::addFloatArray(), Cantera::addInteger(), Cantera::addNamedFloatArray(), Cantera::addString(), XML_Node::copy(), XML_Node::copyUnion(), FixedChemPotSSTP::FixedChemPotSSTP(), MetalSHEelectrons::makeDefaultXMLTree(), StFlow::save(), Inlet1D::save(), Empty1D::save(), Symm1D::save(), Outlet1D::save(), OutletRes1D::save(), Surf1D::save(), ReactingSurf1D::save(), and Domain1D::save().

void addAttribute	(	const std::string &	attrib,
		const doublereal	value,
		const std::string &	fmt = `"%g"`
	)

Add or modify an attribute to the double, value.

This functions fills in the attribute field, named attrib, with the double value, value. A formatting string is used.

Parameters

attrib	String name for the attribute to be assigned
value	double Value that the node will be assigned
fmt	Format of the printf string conversion of the double. Default is "%g".

Definition at line 506 of file xml.cpp.

References XML_Node::attrib(), Cantera::fp2str(), and XML_Node::m_attribs.

void addAttribute	(	const std::string &	attrib,
		int	value
	)

Add an integer attribute.

Parameters

attrib	String name for the attribute to be assigned
value	int Value that the node will be assigned

Definition at line 512 of file xml.cpp.

References Cantera::int2str(), and XML_Node::m_attribs.

void addAttribute	(	const std::string &	attrib,
		size_t	value
	)

Add an unsigned integer attribute.

Parameters

attrib	String name for the attribute to be assigned
value	int Value that the node will be assigned

Definition at line 517 of file xml.cpp.

References Cantera::int2str(), and XML_Node::m_attribs.

std::string operator[] ( const std::string & attr ) const

The operator[] is overloaded to provide a lookup capability on attributes for the current XML element.

For example xmlNode["id"] will return the value of the attribute "id" for the current XML element. It will return the blank std::string if there isn't an attribute with that name.

Parameters

attr	attribute string to look up

Returns: Returns a string representing the value of the attribute within the XML node. If there is no attribute with the given name, it returns the null string.

Definition at line 522 of file xml.cpp.

References XML_Node::attrib().

std::string attrib ( const std::string & attr ) const

Function returns the value of an attribute.

This function searches the attributes vector for the attribute named 'attr'. If a match is found, the attribute value is returned as a string. If no match is found, the empty string is returned.

Parameters

attr	String containing the attribute to be searched for.

Returns: Returns If a match is found, the attribute value is returned as a string. If no match is found, the empty string is returned.

Definition at line 527 of file xml.cpp.

References XML_Node::m_attribs.

Referenced by XML_Node::_require(), XML_Node::addAttribute(), PDSS_ConstVol::constructPDSSXML(), PDSS_IonsFromNeutral::constructPDSSXML(), PDSS_HKFT::constructPDSSXML(), PDSS_SSVol::constructPDSSXML(), IonsFromNeutralVPSSTP::constructPhaseXML(), HMWSoln::constructPhaseXML(), XML_Node::copyUnion(), VPSSMgr_IdealGas::createInstallPDSS(), VPSSMgr_Water_ConstVol::createInstallPDSS(), VPSSMgr_Water_HKFT::createInstallPDSS(), VPSSMgr_ConstVol::createInstallPDSS(), XML_Node::findByAttr(), XML_Node::findID(), XML_Node::findNameIDIndex(), Cantera::getFloatArray(), TransportFactory::getLiquidInteractionsTransportData(), Cantera::getNamedStringValue(), Cantera::getRateCoefficient(), Cantera::getSpeciesThermoTypes(), Cantera::getString(), Cantera::getVPSSMgrTypes(), XML_Node::id(), LiquidTranInteraction::init(), SimpleTransport::initLiquid(), VPSSMgr_Water_ConstVol::initThermoXML(), VPSSMgr_ConstVol::initThermoXML(), VPSSMgr_Water_HKFT::initThermoXML(), MolarityIonicVPSSTP::initThermoXML(), MaskellSolidSolnPhase::initThermoXML(), IdealSolnGasVPSS::initThermoXML(), MineralEQ3::initThermoXML(), RedlichKisterVPSSTP::initThermoXML(), MixedSolventElectrolyte::initThermoXML(), MargulesVPSSTP::initThermoXML(), IonsFromNeutralVPSSTP::initThermoXML(), IdealMolalSoln::initThermoXML(), PhaseCombo_Interaction::initThermoXML(), LatticePhase::initThermoXML(), IdealSolidSolnPhase::initThermoXML(), DebyeHuckel::initThermoXML(), HMWSoln::initThermoXML(), Cantera::installElements(), Cantera::installReactionArrays(), Cantera::newMu0ThermoFromXML(), TransportFactory::newTransport(), XML_Node::operator[](), HMWSoln::readXMLBinarySalt(), RedlichKisterVPSSTP::readXMLBinarySpecies(), MixedSolventElectrolyte::readXMLBinarySpecies(), MargulesVPSSTP::readXMLBinarySpecies(), PhaseCombo_Interaction::readXMLBinarySpecies(), RedlichKwongMFTP::readXMLCrossFluid(), HMWSoln::readXMLLambdaNeutral(), HMWSoln::readXMLMunnnNeutral(), HMWSoln::readXMLPsiCommonAnion(), HMWSoln::readXMLPsiCommonCation(), RedlichKwongMFTP::readXMLPureFluid(), HMWSoln::readXMLThetaAnion(), HMWSoln::readXMLThetaCation(), HMWSoln::readXMLZetaCation(), Inlet1D::restore(), OutletRes1D::restore(), ReactingSurf1D::restore(), and VPSSMgr_General::returnPDSS_ptr().

void clear ( )

Clear the current node and everything under it.

The value, attributes and children are all zeroed. The name and the parent information is kept.

Definition at line 381 of file xml.cpp.

References XML_Node::m_attribs, XML_Node::m_childindex, XML_Node::m_children, XML_Node::m_iscomment, XML_Node::m_linenum, XML_Node::m_value, and XML_Node::parent().

std::map< std::string, std::string > & attribs ( )

private

Returns a changeable value of the attributes map for the current node.

Note this is a simple accessor routine. And, it is a private function. It's used in some internal copy and assignment routines

Definition at line 532 of file xml.cpp.

References XML_Node::m_attribs.

Referenced by XML_Node::build().

const std::map< std::string, std::string > & attribsConst ( ) const

Returns an unchangeable value of the attributes map for the current node.

Returns: Returns an unchangeable reference to the attributes map

Definition at line 537 of file xml.cpp.

References XML_Node::m_attribs.

void setLineNumber ( const int n )

Set the line number.

Parameters

n	the member data m_linenum is set to n

Definition at line 542 of file xml.cpp.

References XML_Node::m_linenum.

Referenced by XML_Node::build(), and XML_Node::copy().

int lineNumber ( ) const

Return the line number.

Returns: returns the member data m_linenum

Definition at line 547 of file xml.cpp.

References XML_Node::m_linenum.

Referenced by XML_Node::child().

XML_Node * parent ( ) const

Returns a pointer to the parent node of the current node.

Definition at line 552 of file xml.cpp.

References XML_Node::m_parent.

Referenced by XML_Node::build(), XML_Node::clear(), Cantera::getByTitle(), and Cantera::importKinetics().

XML_Node * setParent ( XML_Node *const p )

Sets the pointer for the parent node of the current node.

Parameters

p	Pointer to the parent node

Returns: Returns the pointer p

Definition at line 557 of file xml.cpp.

References XML_Node::m_parent.

Referenced by XML_Node::mergeAsChild().

bool hasChild ( const std::string & ch ) const

Tests whether the current node has a child node with a particular name.

Parameters

ch	Name of the child node to test

Returns: Returns true if the child node exists, false otherwise.

Definition at line 563 of file xml.cpp.

References XML_Node::m_childindex.

Referenced by Phase::addElement(), Elements::addElementsFromXML(), Elements::addUniqueElement(), PDSS_HKFT::constructPDSSXML(), IonsFromNeutralVPSSTP::constructPhaseXML(), HMWSoln::constructPhaseXML(), Cantera::getChildValue(), Cantera::getFloat(), Cantera::getInteger(), TransportFactory::getLiquidInteractionsTransportData(), TransportFactory::getLiquidSpeciesTransportData(), Cantera::getNamedStringValue(), Cantera::getOptionalFloat(), Cantera::getOptionalModel(), Cantera::getReagents(), Cantera::getSpeciesThermoTypes(), Cantera::getVPSSMgrTypes(), Cantera::importKinetics(), Cantera::importPhase(), LiquidTranInteraction::init(), SimpleTransport::initLiquid(), MolarityIonicVPSSTP::initThermoXML(), MaskellSolidSolnPhase::initThermoXML(), IdealSolnGasVPSS::initThermoXML(), MineralEQ3::initThermoXML(), StoichSubstanceSSTP::initThermoXML(), MetalSHEelectrons::initThermoXML(), RedlichKwongMFTP::initThermoXML(), RedlichKisterVPSSTP::initThermoXML(), MixedSolventElectrolyte::initThermoXML(), FixedChemPotSSTP::initThermoXML(), MargulesVPSSTP::initThermoXML(), IonsFromNeutralVPSSTP::initThermoXML(), IdealMolalSoln::initThermoXML(), PhaseCombo_Interaction::initThermoXML(), LatticePhase::initThermoXML(), IdealSolidSolnPhase::initThermoXML(), DebyeHuckel::initThermoXML(), ThermoPhase::initThermoXML(), HMWSoln::initThermoXML(), Cantera::installElements(), Cantera::installReactionArrays(), LTPspecies::LTPspecies(), Cantera::newAdsorbateThermoFromXML(), Cantera::newMu0ThermoFromXML(), Cantera::newNasa9ThermoFromXML(), Cantera::newReaction(), Cantera::newSpecies(), TransportFactory::newTransport(), VPSSMgrFactory::newVPSSMgr(), HMWSoln::readXMLCroppingCoefficients(), StFlow::restore(), MetalSHEelectrons::setParametersFromXML(), SurfPhase::setStateFromXML(), MixtureFugacityTP::setStateFromXML(), MolalityVPSSTP::setStateFromXML(), ThermoPhase::setStateFromXML(), TransportFactory::setupLiquidTransport(), and TransportFactory::setupSolidTransport().

bool hasAttrib ( const std::string & a ) const

Tests whether the current node has an attribute with a particular name.

Parameters

a	Name of the attribute to test

Returns: Returns true if the attribute exists, false otherwise.

Definition at line 568 of file xml.cpp.

References XML_Node::m_attribs.

Referenced by XML_Node::_require(), Phase::addElement(), Elements::addElementsFromXML(), Elements::addUniqueElement(), XML_Node::copyUnion(), XML_Node::findByAttr(), XML_Node::findID(), XML_Node::id(), Cantera::importPhase(), MineralEQ3::initThermoXML(), DebyeHuckel::initThermoXML(), HMWSoln::initThermoXML(), Cantera::installElements(), Cantera::newAdsorbateThermoFromXML(), Cantera::newNasa9ThermoFromXML(), Cantera::newNasaThermoFromXML(), and Cantera::newStatMechThermoFromXML().

std::string name ( ) const

inline

Returns the name of the XML node.

The name is the XML node is the XML node name

Definition at line 394 of file xml.h.

References XML_Node::m_name.

Referenced by XML_Node::_require(), XML_Node::build(), PDSS_ConstVol::constructPDSSXML(), PDSS_IonsFromNeutral::constructPDSSXML(), PDSS_HKFT::constructPDSSXML(), PDSS_SSVol::constructPDSSXML(), XML_Node::copy(), XML_Node::copyUnion(), VPSSMgr_Water_ConstVol::createInstallPDSS(), XML_Node::findByName(), XML_Node::findNameID(), XML_Node::findNameIDIndex(), Cantera::findXMLPhase(), XML_Node::getChildren(), Cantera::getFloat(), Cantera::getFloatArray(), Cantera::getFloatCurrent(), Cantera::getInteger(), TransportFactory::getLiquidInteractionsTransportData(), TransportFactory::getLiquidSpeciesTransportData(), Cantera::getNamedStringValue(), Cantera::getRateCoefficient(), TransportFactory::getSolidTransportData(), Cantera::getString(), Cantera::importPhase(), LiquidTranInteraction::init(), MolarityIonicVPSSTP::initThermoXML(), RedlichKwongMFTP::initThermoXML(), RedlichKisterVPSSTP::initThermoXML(), MixedSolventElectrolyte::initThermoXML(), MargulesVPSSTP::initThermoXML(), PhaseCombo_Interaction::initThermoXML(), HMWSoln::initThermoXML(), LTPspecies_Arrhenius::LTPspecies_Arrhenius(), LTPspecies_Const::LTPspecies_Const(), XML_Node::mergeAsChild(), Cantera::newNasa9ThermoFromXML(), HMWSoln::readXMLBinarySalt(), MolarityIonicVPSSTP::readXMLBinarySpecies(), RedlichKisterVPSSTP::readXMLBinarySpecies(), MixedSolventElectrolyte::readXMLBinarySpecies(), MargulesVPSSTP::readXMLBinarySpecies(), PhaseCombo_Interaction::readXMLBinarySpecies(), RedlichKwongMFTP::readXMLCrossFluid(), HMWSoln::readXMLLambdaNeutral(), HMWSoln::readXMLMunnnNeutral(), HMWSoln::readXMLPsiCommonAnion(), HMWSoln::readXMLPsiCommonCation(), RedlichKwongMFTP::readXMLPureFluid(), HMWSoln::readXMLThetaAnion(), HMWSoln::readXMLThetaCation(), HMWSoln::readXMLZetaCation(), XML_Node::removeChild(), Inlet1D::restore(), OutletRes1D::restore(), ReactingSurf1D::restore(), and Cantera::speciesXML_Node().

void setName ( const std::string & name_ )

inline

Sets the name of the XML node.

Parameters

name_ The name of the XML node

Definition at line 402 of file xml.h.

References XML_Node::m_name.

Referenced by XML_Node::build(), and XML_Node::copy().

std::string id ( ) const

Return the id attribute, if present.

Returns the id attribute if present. If not it return the empty string

Definition at line 448 of file xml.cpp.

References XML_Node::attrib(), and XML_Node::hasAttrib().

Referenced by IonsFromNeutralVPSSTP::constructPhaseXML(), HMWSoln::constructPhaseXML(), XML_Node::findNameID(), XML_Node::findNameIDIndex(), Cantera::findXMLPhase(), Cantera::importPhase(), MaskellSolidSolnPhase::initThermoXML(), MolarityIonicVPSSTP::initThermoXML(), RedlichKisterVPSSTP::initThermoXML(), MixedSolventElectrolyte::initThermoXML(), MargulesVPSSTP::initThermoXML(), IonsFromNeutralVPSSTP::initThermoXML(), IdealMolalSoln::initThermoXML(), PhaseCombo_Interaction::initThermoXML(), LatticePhase::initThermoXML(), IdealSolidSolnPhase::initThermoXML(), DebyeHuckel::initThermoXML(), HMWSoln::initThermoXML(), Phase::operator=(), and Phase::setXMLdata().

XML_Node & child ( const size_t n ) const

Return a changeable reference to the n'th child of the current node.

Parameters

n	Number of the child to return

Definition at line 573 of file xml.cpp.

References XML_Node::m_children.

Referenced by Phase::addElement(), Elements::addElementsFromXML(), Elements::addUniqueElement(), PDSS_ConstVol::constructPDSSFile(), PDSS_IonsFromNeutral::constructPDSSFile(), PDSS_HKFT::constructPDSSFile(), PDSS_SSVol::constructPDSSFile(), IonsFromNeutralVPSSTP::constructPhaseXML(), HMWSoln::constructPhaseXML(), VPSSMgr_IdealGas::createInstallPDSS(), electrodeElectron::electrodeElectron(), FixedChemPotSSTP::FixedChemPotSSTP(), Cantera::formSpeciesXMLNodeList(), XML_Node::getChildren(), Cantera::getFloat(), Cantera::getInteger(), TransportFactory::getLiquidInteractionsTransportData(), TransportFactory::getLiquidSpeciesTransportData(), Cantera::getNamedStringValue(), Cantera::getOptionalModel(), Cantera::getRateCoefficient(), Cantera::getReactions(), Cantera::getReagents(), TransportFactory::getSolidTransportData(), Cantera::getSpecies(), Cantera::getSpeciesThermoTypes(), Cantera::getVPSSMgrTypes(), Cantera::importKinetics(), Cantera::importPhase(), LiquidTranInteraction::init(), SimpleTransport::initLiquid(), VPSSMgr_Water_ConstVol::initThermoXML(), VPSSMgr_ConstVol::initThermoXML(), VPSSMgr_Water_HKFT::initThermoXML(), MaskellSolidSolnPhase::initThermoXML(), MolarityIonicVPSSTP::initThermoXML(), IdealSolnGasVPSS::initThermoXML(), MineralEQ3::initThermoXML(), StoichSubstanceSSTP::initThermoXML(), MetalSHEelectrons::initThermoXML(), RedlichKwongMFTP::initThermoXML(), RedlichKisterVPSSTP::initThermoXML(), MixedSolventElectrolyte::initThermoXML(), FixedChemPotSSTP::initThermoXML(), MargulesVPSSTP::initThermoXML(), IonsFromNeutralVPSSTP::initThermoXML(), IdealMolalSoln::initThermoXML(), PhaseCombo_Interaction::initThermoXML(), LatticePhase::initThermoXML(), IdealSolidSolnPhase::initThermoXML(), DebyeHuckel::initThermoXML(), ThermoPhase::initThermoXML(), HMWSoln::initThermoXML(), Cantera::installElements(), Cantera::installReactionArrays(), LatticeSolidPhase::installSlavePhases(), VPSSMgr::installSTSpecies(), SpeciesThermoFactory::installThermoForSpecies(), MetalSHEelectrons::MetalSHEelectrons(), MineralEQ3::MineralEQ3(), Cantera::newAdsorbateThermoFromXML(), KineticsFactory::newKinetics(), Cantera::newNasa9ThermoFromXML(), Cantera::newNasaThermoFromXML(), Cantera::newPhase(), Cantera::newReaction(), Cantera::newSpecies(), TransportFactory::newTransport(), VPSSMgrFactory::newVPSSMgr(), Cantera::readFalloff(), HMWSoln::readXMLBinarySalt(), RedlichKisterVPSSTP::readXMLBinarySpecies(), MixedSolventElectrolyte::readXMLBinarySpecies(), MargulesVPSSTP::readXMLBinarySpecies(), PhaseCombo_Interaction::readXMLBinarySpecies(), HMWSoln::readXMLCroppingCoefficients(), RedlichKwongMFTP::readXMLCrossFluid(), HMWSoln::readXMLLambdaNeutral(), HMWSoln::readXMLMunnnNeutral(), HMWSoln::readXMLPsiCommonAnion(), HMWSoln::readXMLPsiCommonCation(), RedlichKwongMFTP::readXMLPureFluid(), HMWSoln::readXMLThetaAnion(), HMWSoln::readXMLThetaCation(), HMWSoln::readXMLZetaCation(), StFlow::restore(), Inlet1D::restore(), OutletRes1D::restore(), ReactingSurf1D::restore(), LatticeSolidPhase::setParametersFromXML(), TransportFactory::setupLiquidTransport(), TransportFactory::setupSolidTransport(), StoichSubstanceSSTP::StoichSubstanceSSTP(), SurfPhase::SurfPhase(), and XML_Node::value().

const std::vector< XML_Node * > & children ( ) const

Return an unchangeable reference to the vector of children of the current node.

Each of the individual XML_Node child pointers, however, is to a changeable XML node object.

Definition at line 578 of file xml.cpp.

References XML_Node::m_children.

Referenced by XML_Node::copy(), XML_Node::copyUnion(), Cantera::findXMLPhase(), and Cantera::newSpeciesThermoInterpType().

size_t nChildren ( bool discardComments = false ) const

Return the number of children.

Parameters

discardComments If true comments are discarded when adding up the number of children. Defaults to false.

Definition at line 583 of file xml.cpp.

References XML_Node::isComment(), and XML_Node::m_children.

Referenced by XML_Node::copy(), XML_Node::copyUnion(), XML_Node::findByAttr(), XML_Node::findByName(), XML_Node::findID(), Cantera::findXMLPhase(), Cantera::formSpeciesXMLNodeList(), XML_Node::getChildren(), TransportFactory::getLiquidInteractionsTransportData(), TransportFactory::getLiquidSpeciesTransportData(), Cantera::getRateCoefficient(), TransportFactory::getSolidTransportData(), LiquidTranInteraction::init(), MolarityIonicVPSSTP::initThermoXML(), RedlichKwongMFTP::initThermoXML(), RedlichKisterVPSSTP::initThermoXML(), MixedSolventElectrolyte::initThermoXML(), MargulesVPSSTP::initThermoXML(), PhaseCombo_Interaction::initThermoXML(), HMWSoln::initThermoXML(), HMWSoln::readXMLBinarySalt(), RedlichKisterVPSSTP::readXMLBinarySpecies(), MixedSolventElectrolyte::readXMLBinarySpecies(), MargulesVPSSTP::readXMLBinarySpecies(), PhaseCombo_Interaction::readXMLBinarySpecies(), RedlichKwongMFTP::readXMLCrossFluid(), HMWSoln::readXMLLambdaNeutral(), HMWSoln::readXMLMunnnNeutral(), HMWSoln::readXMLPsiCommonAnion(), HMWSoln::readXMLPsiCommonCation(), RedlichKwongMFTP::readXMLPureFluid(), HMWSoln::readXMLThetaAnion(), HMWSoln::readXMLThetaCation(), HMWSoln::readXMLZetaCation(), Inlet1D::restore(), OutletRes1D::restore(), and ReactingSurf1D::restore().

bool isComment ( ) const

Boolean function indicating whether a comment.

Definition at line 598 of file xml.cpp.

References XML_Node::m_iscomment.

Referenced by XML_Node::nChildren().

void _require	(	const std::string &	a,
		const std::string &	v
	)		const

Require that the current XML node have an attribute named by the first argument, a, and that this attribute have the the string value listed in the second argument, v.

Parameters

a	attribute name
v	required value of the attribute

If the condition is not true, an exception is thrown

Definition at line 603 of file xml.cpp.

References XML_Node::attrib(), XML_Node::hasAttrib(), and XML_Node::name().

Referenced by SemiconductorPhase::setParametersFromXML(), EdgePhase::setParametersFromXML(), MetalPhase::setParametersFromXML(), ConstDensityThermo::setParametersFromXML(), StoichSubstance::setParametersFromXML(), SurfPhase::setParametersFromXML(), WaterSSTP::setParametersFromXML(), PureFluidPhase::setParametersFromXML(), LatticeSolidPhase::setParametersFromXML(), and LatticePhase::setParametersFromXML().

XML_Node * findNameID	(	const std::string &	nameTarget,
		const std::string &	idTarget
	)		const

This routine carries out a recursive search for an XML node based on both the XML element name and the attribute ID.

If exact matches are found for both fields, the pointer to the matching XML Node is returned.

The ID attribute may be defaulted by setting it to "". In this case the pointer to the first XML element matching the name only is returned.

Parameters

nameTarget	Name of the XML Node that is being searched for
idTarget	"id" attribute of the XML Node that the routine looks for

Returns: Returns the pointer to the XML node that fits the criteria

This algorithm does a lateral search of first generation children first before diving deeper into each tree branch.

Definition at line 615 of file xml.cpp.

References XML_Node::findNameID(), XML_Node::id(), XML_Node::m_children, and XML_Node::name().

Referenced by XML_Node::findNameID(), and Cantera::get_XML_NameID().

XML_Node * findNameIDIndex	(	const std::string &	nameTarget,
		const std::string &	idTarget,
		const int	index
	)		const

This routine carries out a search for an XML node based on both the XML element name and the attribute ID and an integer index.

If exact matches are found for all fields, the pointer to the matching XML Node is returned. The search is only carried out on the current element and the child elements of the current element.

The "id" attribute may be defaulted by setting it to "". In this case the pointer to the first XML element matching the name only is returned.

Parameters

nameTarget	Name of the XML Node that is being searched for
idTarget	"id" attribute of the XML Node that the routine looks for
index	Integer describing the index. The index is an attribute of the form index = "3"

Returns: Returns the pointer to the XML node that fits the criteria

Definition at line 648 of file xml.cpp.

References XML_Node::attrib(), XML_Node::id(), Cantera::int2str(), XML_Node::m_children, and XML_Node::name().

XML_Node * findID	(	const std::string &	id,
		const int	depth = `100`
	)		const

This routine carries out a recursive search for an XML node based on the XML element attribute, "id".

If exact match is found, the pointer to the matching XML Node is returned. If not, 0 is returned.

The ID attribute may be defaulted by setting it to "". In this case the pointer to the first XML element matching the name only is returned.

Parameters

id	"id" attribute of the XML Node that the routine looks for
depth	Depth of the search.

Returns: Returns the pointer to the XML node that fits the criteria

This algorithm does a lateral search of first generation children first before diving deeper into each tree branch.

Definition at line 685 of file xml.cpp.

References XML_Node::attrib(), XML_Node::hasAttrib(), XML_Node::m_children, and XML_Node::nChildren().

Referenced by Cantera::get_XML_Node(), and Sim1D::restore().

XML_Node * findByAttr	(	const std::string &	attr,
		const std::string &	val,
		int	depth = `100000`
	)		const

This routine carries out a recursive search for an XML node based on an attribute of each XML node.

If exact match is found with respect to the attribute name and value of the attribute, the pointer to the matching XML Node is returned. If not, 0 is returned.

Parameters

attr	Attribute of the XML Node that the routine looks for
val	Value of the attribute
depth	Depth of the search. A value of 1 means that only the immediate children are searched.

Returns: Returns the pointer to the XML node that fits the criteria

Definition at line 704 of file xml.cpp.

References XML_Node::attrib(), XML_Node::hasAttrib(), XML_Node::m_children, and XML_Node::nChildren().

Referenced by Elements::addElementsFromXML(), PDSS_ConstVol::constructPDSSFile(), PDSS_IonsFromNeutral::constructPDSSFile(), PDSS_HKFT::constructPDSSFile(), PDSS_SSVol::constructPDSSFile(), Cantera::getByTitle(), VPSSMgr_Water_ConstVol::initThermoXML(), VPSSMgr_ConstVol::initThermoXML(), VPSSMgr_Water_HKFT::initThermoXML(), IdealMolalSoln::initThermoXML(), LatticePhase::initThermoXML(), IdealSolidSolnPhase::initThermoXML(), DebyeHuckel::initThermoXML(), HMWSoln::initThermoXML(), and Cantera::installElements().

const XML_Node * findByName	(	const std::string &	nm,
		int	depth = `100000`
	)		const

This routine carries out a recursive search for an XML node based on the name of the node.

If exact match is found with respect to XML_Node name, the pointer to the matching XML Node is returned. If not, 0 is returned. This is the const version of the routine.

Parameters

nm	Name of the XML node
depth	Depth of the search. A value of 1 means that only the immediate children are searched.

Returns: Returns the pointer to the XML node that fits the criteria

Definition at line 742 of file xml.cpp.

References XML_Node::m_children, XML_Node::name(), and XML_Node::nChildren().

Referenced by PDSS_ConstVol::constructPDSSXML(), PDSS_IonsFromNeutral::constructPDSSXML(), PDSS_HKFT::constructPDSSXML(), PDSS_SSVol::constructPDSSXML(), VPSSMgr_IdealGas::createInstallPDSS(), VPSSMgr_Water_ConstVol::createInstallPDSS(), VPSSMgr_Water_HKFT::createInstallPDSS(), VPSSMgr_ConstVol::createInstallPDSS(), VPSSMgr_Water_ConstVol::initThermoXML(), VPSSMgr_ConstVol::initThermoXML(), VPSSMgr_Water_HKFT::initThermoXML(), IdealMolalSoln::initThermoXML(), LatticePhase::initThermoXML(), IdealSolidSolnPhase::initThermoXML(), DebyeHuckel::initThermoXML(), HMWSoln::initThermoXML(), and VPSSMgr_General::returnPDSS_ptr().

XML_Node * findByName	(	const std::string &	nm,
		int	depth = `100000`
	)

This routine carries out a recursive search for an XML node based on the name of the node.

If exact match is found with respect to XML_Node name, the pointer to the matching XML Node is returned. If not, 0 is returned. This is the non-const version of the routine.

Parameters

nm	Name of the XML node
depth	Depth of the search. A value of 1 means that only the immediate children are searched.

Returns: Returns the pointer to the XML node that fits the criteria

Definition at line 725 of file xml.cpp.

References XML_Node::m_children, XML_Node::name(), and XML_Node::nChildren().

void getChildren	(	const std::string &	name,
		std::vector< XML_Node * > &	children
	)		const

Get a vector of pointers to XML_Node containing all of the children of the current node which matches the input name.

Parameters

name	Name of the XML_Node children to search on
children	output vector of pointers to XML_Node children with the matching name

Deprecated:: To be removed after Cantera 2.2. Use the version that returns the vector of child nodes

Definition at line 915 of file xml.cpp.

References XML_Node::child(), XML_Node::name(), XML_Node::nChildren(), and Cantera::warn_deprecated().

Referenced by Cantera::formSpeciesXMLNodeList(), Cantera::getCoverageDependence(), Cantera::getFloatArray(), Cantera::getIntegers(), Cantera::getReactions(), Cantera::getReagents(), Cantera::getSpecies(), Cantera::importPhase(), Cantera::installReactionArrays(), LatticeSolidPhase::installSlavePhases(), Sim1D::restore(), StFlow::restore(), Domain1D::restore(), LatticeSolidPhase::setParametersFromXML(), and Cantera::speciesXML_Node().

std::vector< XML_Node * > getChildren ( const std::string & name ) const

Get a vector of pointers to XML_Node containing all of the children of the current node which match the given name.

Parameters

name	Name of the XML_Node children to search for

Returns: vector of pointers to child XML_Nodes with the matching name

Definition at line 927 of file xml.cpp.

References XML_Node::child(), XML_Node::name(), and XML_Node::nChildren().

XML_Node & child ( const std::string & loc ) const

Return a changeable reference to a child of the current node, named by the argument.

Note the underlying data allows for more than one XML element with the same name. This routine returns the first child with the given name.

Parameters

loc	Name of the child to return

Definition at line 938 of file xml.cpp.

References XML_Node::lineNumber(), XML_Node::m_childindex, XML_Node::m_name, and Cantera::npos.

void writeHeader ( std::ostream & s )

Write the header to the XML file to the specified ostream.

Parameters

s	ostream to write the output to

Definition at line 759 of file xml.cpp.

void write	(	std::ostream &	s,
		const int	level = `0`,
		int	numRecursivesAllowed = `60000`
	)		const

Write an XML subtree to an output stream.

This is a wrapper around the static routine write_int(). All this does is add an endl on to the output stream. write_int() is fine, but the last endl wasn't being written.

Parameters

s	ostream to write to
level	Indentation level to work from
numRecursivesAllowed	Number of recursive calls allowed

Definition at line 1089 of file xml.cpp.

References XML_Node::write_int().

Referenced by XML_NoChild::XML_NoChild().

XML_Node & root ( ) const

Return the root of the current XML_Node tree.

Returns a reference to the root of the current XML tree

Definition at line 1095 of file xml.cpp.

References XML_Node::m_root.

Referenced by Elements::addElementsFromXML(), PDSS_ConstVol::constructPDSSFile(), PDSS_IonsFromNeutral::constructPDSSFile(), PDSS_HKFT::constructPDSSFile(), PDSS_SSVol::constructPDSSFile(), Cantera::importPhase(), VPSSMgr_Water_ConstVol::initThermoXML(), VPSSMgr_ConstVol::initThermoXML(), VPSSMgr_Water_HKFT::initThermoXML(), IdealMolalSoln::initThermoXML(), LatticePhase::initThermoXML(), IdealSolidSolnPhase::initThermoXML(), DebyeHuckel::initThermoXML(), HMWSoln::initThermoXML(), Cantera::installElements(), Cantera::installReactionArrays(), XML_Node::mergeAsChild(), Phase::operator=(), Phase::setXMLdata(), XML_Node::XML_Node(), and Phase::~Phase().

void setRoot ( const XML_Node & root )

Set the root XML_Node value within the current node.

Parameters

root	Value of the root XML_Node.

Definition at line 1100 of file xml.cpp.

References XML_Node::m_children, and XML_Node::m_root.

Referenced by XML_Node::mergeAsChild().

void build ( std::istream & f )

Main routine to create an tree-like representation of an XML file.

Given an input stream, this routine will read matched XML tags representing the ctml file until an EOF is read from the file. This routine is called by the root XML_Node object.

Parameters

f	Input stream containing the ascii input file

Definition at line 764 of file xml.cpp.

References XML_Node::addComment(), XML_Node::addValue(), XML_Node::attribs(), XML_Reader::m_line, XML_Node::m_name, XML_Node::m_root, XML_Node::name(), XML_Node::parent(), XML_Reader::readTag(), XML_Reader::readValue(), XML_Node::setLineNumber(), and XML_Node::setName().

Referenced by PDSS_IdealGas::constructPDSSFile(), PDSS_ConstVol::constructPDSSFile(), PDSS_IonsFromNeutral::constructPDSSFile(), PDSS_HKFT::constructPDSSFile(), PDSS_Water::constructPDSSFile(), PDSS_SSVol::constructPDSSFile(), IonsFromNeutralVPSSTP::constructPhaseFile(), HMWSoln::constructPhaseFile(), Application::get_XML_File(), and Sim1D::restore().

void copyUnion ( XML_Node *const node_dest ) const

Copy all of the information in the current XML_Node tree into the destination XML_Node tree, doing a union operation as we go.

Note this is a const function because the current XML_Node and its children isn't altered by this operation. copyUnion() doesn't duplicate existing entries in the destination XML_Node tree.

Parameters

node_dest This is the XML node to receive the information

Definition at line 820 of file xml.cpp.

References XML_Node::addAttribute(), XML_Node::addValue(), XML_Node::attrib(), XML_Node::children(), XML_Node::copyUnion(), XML_Node::hasAttrib(), XML_Node::m_attribs, XML_Node::m_children, XML_Node::m_iscomment, XML_Node::m_name, XML_Node::m_value, XML_Node::name(), and XML_Node::nChildren().

Referenced by XML_Node::copyUnion().

void copy ( XML_Node *const node_dest ) const

Copy all of the information in the current XML_Node tree into the destination XML_Node tree, doing a complete copy as we go.

Note this is a const function because the current XML_Node and its children isn't altered by this operation.

Parameters

node_dest This is the XML node to receive the information

Definition at line 874 of file xml.cpp.

References XML_Node::addAttribute(), XML_Node::addValue(), XML_Node::children(), XML_Node::copy(), XML_Node::m_attribs, XML_Node::m_children, XML_Node::m_linenum, XML_Node::m_name, XML_Node::m_value, XML_Node::name(), XML_Node::nChildren(), XML_Node::setLineNumber(), and XML_Node::setName().

Referenced by XML_Node::copy(), Cantera::get_CTML_Tree(), and Cantera::getCtmlTree().

void lock ( )

Set the lock for this node and all of its children.

Definition at line 899 of file xml.cpp.

References XML_Node::m_children, and XML_Node::m_locked.

Referenced by Application::get_XML_File().

void unlock ( )

Unset the lock for this node and all of its children.

Definition at line 907 of file xml.cpp.

References XML_Node::m_children, and XML_Node::m_locked.

void write_int	(	std::ostream &	s,
		int	level = `0`,
		int	numRecursivesAllowed = `60000`
	)		const

private

Write an XML subtree to an output stream.

This is the main recursive routine. It doesn't put a final endl on. This is fixed up in the public method. A method to only write out a limited amount of the XML tree has been added.

Parameters