This is a family of routines which set a specified attribute value for an Object using one of several different data types. The type is selected by replacing $<$X$>$ in the routine name by C, D, I, L or R, to supply a value in Character, Double precision, Integer, Logical or Real format, respectively.

If possible, the value you supply is converted to the type of the attribute. If conversion is not possible, an error will result.

CALL AST_SET$<$X$>$( THIS, ATTRIB, VALUE, STATUS )

THIS = INTEGER (Given)

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

VALUE = $<$X$>$type (Given)

STATUS = INTEGER (Given and Returned)

Object

CALL AST_SETC( PLOT, ’Title’ , CVALUE, STATUS )

Sets the Title attribute value for Object PLOT to the contents of the character variable CVALUE.

CALL AST_SETL( FRAME, ’ Preserve’ , .TRUE., STATUS );

Sets the Preserve attribute value for Object FRAME to 1 (true).

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

• The logical value .FALSE. will translate to a numerical attribute value of zero and logical .TRUE. will translate to one.

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