getNthDocument (DocumentCollection - Java™)

コレクション内の指定された位置番号の文書を返します。

定義位置

DocumentCollection

構文

public Document getNthDocument(int n)
    throws NotesException

パラメータ

int n

整数。返される文書の位置を示す番号。 1 はコレクションの最初の文書、2 は 2 番目の文書というように文書を示します。

戻り値

Document

コレクション内の n 番目の位置にある文書を返します。指定された位置に文書がない場合は、null を返します。

使用法

文書が削除されるとコレクション内では番号が付け直されるため、削除された文書の後にある文書の位置が変更されます。

パフォーマンス上の理由により、getNthDocument と getCount を共に使用してループを繰り返す方法は避けるようにしてください。お勧めするループ構造については、getNextDocumentgetPrevDocument を参照してください。

クロスリファレンス

LotusScript® NotesDocumentCollection クラスの GetNthDocument メソッド