db.getNthItem

Syntax db.getNthItem (f, path, n)
Params f is a filespec or path string of a Frontier object database file that has been opened with db.open.

path is a valid UserTalk address string, indicating the location in the database of a table whose contents you wish to examine.

n is the 1-based index into the table of the item whose name you wish to retrieve.
Action Examines the table in the location indicated by path and determines the name of the indicated item that it contains.
Returns The name of the indicated table item.
Examples db.getNthItem ("System:Frontier:old.root", "examples", 4)

   » "cleanupWindows"

db.getNthItem ("System:Frontier:old.root", "examples.age", 29)

   » error: "The address of a table was expected here."
Notes The database file specified in the parameter "f" must be opened using db.open before calling this verb.

path can be a full or partial database address; the paths table of the target database is used to interpret it.

db.getNthItem (f, path, n) is equivalent to nameOf (path^ [n]) when referring to a table in Frontier's current object database.
See Also db.open

db.isTable

db.countItems

nameOf

Discuss