#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.
The XmlValue into which the previous value in the result set is to be placed.
The XmlDocument into which the previous value in the result set is to be placed.
The XmlResults::previous
method may
fail and throw
XmlException
, encapsulating one of the
following non-zero errors: