XmlResults::next |
![]() ![]() |
#include <DbXml.hpp>void XmlResults::next(DbTxn *txnid, XmlValue &value);
The XmlResults::next method returns the next value in the results into the memory referenced by value. When no more values remain in the result set, XmlResults::next will return a value with an empty pointer, so that UNREF==xmlv_get will return 0.
The XmlResults::next method throws an exception that encapsulates a non-zero error value on failure.
If the requested item could not be returned due to insufficient memory, the XmlResults::next method will fail and throw a DbMemoryException exception.
The XmlResults::next method may fail and throw an exception for errors specified for other Berkeley DB and C library or system methods. If a catastrophic error has occurred, the XmlResults::next method may fail and throw a DbRunRecoveryException, in which case all subsequent Berkeley DB calls will fail in the same way.
XmlDocument::getAttributeValue, XmlDocument::getContent, XmlDocument::getID, XmlDocument::getName, XmlDocument::getType, XmlDocument::setContent, XmlDocument::setName, and XmlDocument::setType.
![]() ![]() |