# XmlResults

`

###

    #include <DbXml.hpp>

    class DbXml::XmlResults {
    public:
    	XmlResults(const XmlResults &);
    	~XmlResults();
    	XmlResults &operator = (const XmlResults &)
    	...
    };

# Description

The XmlResults class encapsulates the results of a query against an XmlContainer.

The results of a query are a collection of XmlValues. The XmlValues may be either documents or nodesets. If the query context selected a return type of XmlQueryContext::ResultValues then the values will be of type NodeListValue, otherwise they will be of type DocumentValue.

An XmlResults object is created by calling XmlContainer::queryWithXPath. If the query context called for lazy expression evaluation then the resultant values will be computed as needed. If eager evaluation was selected the resultant values are stored within the XmlResults object.

XmlResults provides an iteration interface through its next() method. When there are no more values available the passed back value pointer will be zero. If eager evaluation was selected then the reset method can be called to reset the iterator, and the next call to next() will return the first value of the results.

# 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.

`

Copyright Sleepycat Software