#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.