XmlResults::previous

#include <DbXml.hpp>

bool XmlResults::previous(XmlValue &value);
bool XmlResults::previous(XmlDocument &document);

Retrieves the previous value in the result set. When the first value in the results set has been reached, the XmlResults::previous method returns false. For an eager results set, the iterator logically points "between" adjacent entries which means that alternating calls to previous() and next() will return the same value.

This method can only be used on eagerly evaulated result sets.

Two forms of this method exist: one that places the previous value in an XmlValue object, and another that places the previous value in an XmlDocument object.

Parameters

value

The XmlValue into which the previous value in the result set is to be placed.

document

The XmlDocument into which the previous value in the result set is to be placed.

Errors

The XmlResults::previous method may fail and throw XmlException , encapsulating one of the following non-zero errors:

LAZY_EVALUATION

This method can only be called on eagerly evaluated result sets.

Class

XmlResults

See Also

XmlResults Methods