XmlResults::reset

APIRef

#include <DbXml.hpp>

void XmlResults::reset()

Description

The XmlResults::reset method reset the results iterator, for eager evaluation. If the query was processed with eager evaluation then reset will reset the iterator so a subsequent call to XmlResults::next method will return the first value in the result set. If the query was processed with lazy evaluation then XmlResults::reset will have no effect.

The XmlResults::reset 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::reset method will fail and throw a DbMemoryException exception.

The XmlResults::reset 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::reset 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