Gets the document immediately following the current document or a specified document in a collection.

Defined in

DocumentCollection

Syntax

public Document getNextDocument()
   throws NotesException

public Document getNextDocument(Document doc)
   throws NotesException

Parameters

Document doc

Any document in the collection. Cannot be null.

Document

If no parameter, the document following the current document. If a parameter, the document following the specified document. If there is no next document, returns null.

In remote (IIOP) operations, getNextDocument(Document doc) invalidates the cache and is therefore discouraged.

The preferred loop structure is getFirstDocument() followed by getNextDocument() until it returns null. For performance reasons, you should avoid using getNthDocument(int n) in a loop.

In loops you should recycle the Document object on each iteration. Use a temporary Document object to save and restore the object.

Language cross-reference

GetNextDocument method in LotusScript NotesDocumentCollection class

NavigateNextSelected @command in formula language

NavNextSelected @command in formula language

Example
See Also

Collecting all documents and all unprocessed documents

Glossary