# XmlResults.next

`

###

    import com.sleepycat.dbxml.*;

    public void next(DbTxn txnid, XmlValue value)
        throws XmlException;

# Description

The XmlResults.next method returns the next value in the results into the memory referenced by value. When no more values remain in the result set, XmlResults.next will return a value with an empty pointer, so that UNREF==xmlv_get will return 0.

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

The XmlResults.next 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.next 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.

`

Copyright Sleepycat Software