NBS_PUT_CVALUE
- Put a character string into a slice of a primitive item
associated with a specified identifier
Description:
Simply extract the string data pointer and length and pass this
information to NBS_PUT_VALUE.
Invocation:
(Int) = NBS_PUT_CVALUE (ID,OFFSET,STRING,STATUS)
Arguments:
ID = INTEGER (Given)
Identifier of the item which the value is to be put.
OFFSET = INTEGER (Given)
Byte offset into item data.
STRING = CHARACTER*(*) (Given)
The string to be put.
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__BADOFFSET Negative offset specified
NBS__TOOMANYBYTES Not room to put all the data
Notes:
Replaces NBS_PUT_VALUE when writing character strings to noticeboards.