NBS_PUT_SIZE

Put a new size to a primitive item associated with a specified identifier

Description:

Check that the ID is not NIL and that it pertains to a primitive item.
Check that the caller owns the noticeboard (or WORLD_WRITE is TRUE).
Check that the item is large enough to be the proposed size.
Increment the item’s modified count.
Update the internal record of the item’s size.
Increment the item’s modified count again.
Increment the noticeboard modified count.

The item and noticeboard modified counts will not be incremented if INCREMENT_MODIFY is FALSE.

Invocation

(Int) = NBS_PUT_SIZE (ID,NBYTES,STATUS)

Arguments

ID = INTEGER (Given)
Identifier of the item which the shape is to be put.
NBYTES = INTEGER (Given)
new item size in bytes.
STATUS = INTEGER (Given and returned)
The global status. Possible return values are,
NBS__NILID NIL ID

NBS__NOTPRIMITIVE Item is not primitive

NBS__NOTOWNER Caller does not own the noticeboard

NBS__TOOMANYBYTES NBYTES is greater than item size