NBS_GET_POINTER

Return a pointer to the first byte of the data of a primitive item associated with the specified identifier

Description:

Check that the ID is not NIL and that it pertains to a primitive item.
Return the address of the start of the item’s noticeboard data.

Invocation

(Int) = NBS_GET_POINTER (ID,POINTER,STATUS)

Arguments

ID = INTEGER (Given)
Identifier of the item for which the pointer to its noticeboard data is to be got.
POINTER = INTEGER (Returned)
The address of the first byte of this item’s noticeboard data.
STATUS = INTEGER (Given and returned)
The global status. Possible return values are,
NBS__NILID NIL ID

NBS__NOTPRIMITIVE Item is not primitive