next up previous 372
Next: NBS_LOSE_NOTICEBOARD - Unmap a specified noticeboard
Up: Description of Individual NBS Routines
Previous: NBS_FIND_ITEM - Find an item with a specified name contained in a structure associated with a specified identifier and return


NBS_FIND_NTH_ITEM - Find the Nth item contained in a structure associated with a specified identifier and return the located item's ID

Description:
Check that the environment ID is not NIL and does not pertain to a primitive item.
Extract the Nth item.

Invocation:
(Int) = NBS_FIND_NTH_ITEM (ENVID,POSN,ID,STATUS)

Arguments:

ENVID = INTEGER (Given)
Identifier of the parent of the item which is to be found.
POSN = INTEGER (Given)
Number of item to find (first item is item #1).
ID = INTEGER (Returned)
Identifier of the found item (zero if not found).
STATUS = INTEGER (Given and returned)
The global status. Possible return values are,

NBS__NILID   		 NIL ID 

NBS__PRIMITIVE Parent is primitive
NBS__ITEMNOTFOUND No item of this name exists



next up previous 372
Next: NBS_LOSE_NOTICEBOARD - Unmap a specified noticeboard
Up: Description of Individual NBS Routines
Previous: NBS_FIND_ITEM - Find an item with a specified name contained in a structure associated with a specified identifier and return

NBS The Noticeboard System
Starlink User Note 77
D.J. Allan
11 September 1995
E-mail:ussc@star.rl.ac.uk