XmlResults.next

APIRef

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.

APIRef

Copyright Sleepycat Software