getNthItemValue (DirectoryNavigator - Java)

Positions navigator to nth match of the current name in the navigator and returns the value of the current item.

Note: This method is new with Release 8

Defined in



java.util.Vector getNthItemValue(int n)


int n

The number of the match at which to position the navigator, starting with 1.

Return value


The value of the current item of the nth match.


Positions navigator to the nth match of the current name, and updates the CurrentItem property with the item name.

The only way to advance the current item is by use of the getNextItemValue method.

This method always returns an array. If it is a single valued item, only the first value of the array will be populated.