AST_SET <X >

Set an attribute value for an Object

Description:

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.

Invocation

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

Arguments

THIS = INTEGER (Given)
Pointer to the Object.
ATTRIB = CHARACTER ( ) (Given)
A character string containing the name of the attribute whose value is to be set.
VALUE = <X >type (Given)
The value to be set for the attribute, in the data type corresponding to <X >.
STATUS = INTEGER (Given and Returned)
The global status.

Applicability

Object
These routines apply to all Objects.

Examples:

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).

Notes: