XmlResults::next

APIRef

#include <DbXml.hpp>

void XmlResults::next(DbTxn *txnid, XmlValue &value);

Description

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.

Errors

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.

Class

XmlContainer, XmlDocument, XmlQueryContext

See Also

XmlContainer::close, XmlContainer::declareIndex, XmlContainer::deleteDocument, XmlContainer::getDocument, XmlContainer::getName, XmlContainer::open, XmlContainer::putDocument and XmlContainer::queryWithXPath.

XmlDocument::getAttributeValue, XmlDocument::getContent, XmlDocument::getID, XmlDocument::getName, XmlDocument::getType, XmlDocument::setContent, XmlDocument::setName, and XmlDocument::setType.

APIRef

Copyright Sleepycat Software