This routine assigns a set of attribute values to an Object, over-riding any previous values. The attributes and their new values are specified via a character string, which should contain a comma-separated list of the form:

" attribute_1 = value_1, attribute_2 = value_2, ... "

where " attribute_n" specifies an attribute name, and the value to the right of each " =" sign should be a suitable textual representation of the value to be assigned. This value will be interpreted according to the attribute’ s data type.

CALL AST_SET( THIS, SETTINGS, STATUS )

THIS = INTEGER (Given)

SETTINGS = CHARACTER $\ast$ ( $\ast$ ) (Given)

STATUS = INTEGER (Given and Returned)

Object

CALL AST_SET( MAP, ’Report = 1, Zoom = 25.0’ , STATUS )

Sets the Report attribute for Object MAP to the value 1 and the Zoom attribute to 25.0.

CALL AST_SET( FRAME, ’ Label( 1 ) =Offset from cluster axis’ , STATUS )

Sets the Label(1) attribute for Object FRAME to a suitable string.

• Attribute names are not case sensitive and may be surrounded by white space.

• White space may also surround attribute values, where it will generally be ignored (except for string-valued attributes where it is significant and forms part of the value to be assigned).

• To include a literal comma in the value assigned to an attribute, the whole attribute value should be enclosed in quotation markes.

• An error will result if an attempt is made to set a value for a read-only attribute.