getNthEntry (NotesViewEntryCollection - JavaScript™)

Gets the entry at a specified position in a view entry collection.

Defined in

Syntax

getNthEntry(n:int) : NotesViewEntry


Parameter	Description
`n`	A number indicating the entry to return. Use 1 to indicate the first entry in the collection, 2 to indicate the second entry, and so on.


Return value	Description
`NotesViewEntry`	The entry in the nth position in the view entry collection. If there is no document at the specified position, returns null.

Usage

View collections are renumbered when deletions occur so that the positions of entries after the deleted entry change.

Using this method to iterate through a loop is strongly discouraged for performance reasons. See getFirstEntry, getLastEntry, getNextEntry, and getPrevEntry for the preferred loop structure.

Examples

This button gets the document in a view at a specified position.

var n:int = parseInt(requestScope.query);
if (isNaN(n)) {
	requestScope.status = "Not a number";
	return;
}
var mainview:NotesView =database.getView("main");
var vec:NotesViewEntryCollection = mainview.getAllEntries();
var entry:NotesViewEntry = vec.getNthEntry(n);
if (entry == null) {
	requestScope.status = "No document at that position";
	return;
}
requestScope.status = entry.getDocument().getItemValueString("subject");