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:
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