XmlValue::getNodeHandle

#include <DbXml.hpp>

class DbXml::XmlValue {
public:
	...
	std::string getNodeHandle() const
	...
};

Returns a string handle representing an XmlValue of type XmlValue::NODE, which can be used to construct a new XmlValue object representing the same node, at a later time, using XmlContainer::getNode. The handle returned encodes its document ID; however, it does not include its container. Matching a node handle to container is the responsibility of the caller.

Node handles are guaranteed to remain stable in the absence of modifications to a document. If a document is modified, a handle may cease to exist, or may belong to a different node.

If the node type is not XmlValue::NODE, XmlException::INVALID_VALUE is thrown.

Class

XmlValue

See Also

XmlValue Methods