next up previous 372
Next: NBS_PUT_SHAPE - Put a new shape to a primitive item associated with a specified identifier
Up: Description of Individual NBS Routines
Previous: NBS_PUT_VALUE - Put a byte array into a slice of a primitive item associated with a specified identifier


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.


next up previous 372
Next: NBS_PUT_SHAPE - Put a new shape to a primitive item associated with a specified identifier
Up: Description of Individual NBS Routines
Previous: NBS_PUT_VALUE - Put a byte array into a slice of a primitive item associated with a specified identifier

NBS The Noticeboard System
Starlink User Note 77
D.J. Allan
11 September 1995
E-mail:ussc@star.rl.ac.uk