AST_WRITE

Write an Object to a Channel

Description:

This function writes an Object to a Channel, appending it to any previous Objects written to that Channel.

Invocation

RESULT = AST_WRITE( THIS, OBJECT, STATUS )

Arguments

THIS = INTEGER (Given)
Pointer to the Channel.
OBJECT = INTEGER (Given)
Pointer to the Object which is to be written.
STATUS = INTEGER (Given and Returned)
The global status.

Applicability

FitsChan
If the FitsChan uses a foreign encoding (e.g. FITS-WCS) rather than the native AST encoding, then storing values in the FitsChan for keywords NAXIS1, NAXIS2, etc., before invoking AST_WRITE can help to produce a successful write.

Returned Value

AST_WRITE = INTEGER
The number of Objects written to the Channel by this invocation of AST_WRITE (normally, this will be one).

Notes: