XmlResults::next |
![]() ![]() |
#include <DbXml.hpp>bool XmlResults::next(XmlValue &value); bool XmlResults::next(XmlDocument &document); bool XmlResults::next(XmlDocument &document, XmlValue &value);
The XmlResults::next method retrieves the next value in the result set. When no more values remain in the result set, the XmlResults::next method returns false.
Three implementations of the XmlResults::next method are provided. Their usage depends upon the settings of the XmlQueryContext passed through the XmlContainer::queryWithXPath method. If the context return type was set to ResultValues then next(value) should be used. If the return type was set to ResultDocuments then next(document) can be used as a convenience. If ResultDocumentsAndValues was set then next(document,value) should be used.
If a query was processed with eager evaluation, a call to the XmlResults::reset method resets the result set iterator, so that a subsequent call to XmlResults::next returns the first value in the result set.
The XmlResults::next method retrieves the next value in the result set. When no more values remain in the result set, the XmlResults::next method returns false.
The XmlResults::next method may fail and throw XmlException, encapsulating one of the following non-zero errors:
Returns the next document in the result set.
The XmlResults::next method may fail and throw XmlException, encapsulating one of the following non-zero errors:
Returns the next document and value in the result set.
The XmlResults::next method may fail and throw XmlException, encapsulating one of the following non-zero errors:
![]() ![]() |
Copyright (c) 1996-2003 Sleepycat Software, Inc. - All rights reserved.