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.