AST_WRITEFITS - Write out all cards in a FitsChan to the sink function

Description:

This routine writes out all cards currently in the FitsChan. If the SinkFile attribute is set, they will be written out to the specified sink file. Otherwise, they will be written out using the sink function specified when the FitsChan was created. All cards are then deleted from the FitsChan.

Invocation:

CALL AST_WRITEFITS( THIS, STATUS )

Arguments:

THIS = INTEGER (Given)

Pointer to the FitsChan.

STATUS = INTEGER (Given and Returned)

The global status.

Notes:

• If the SinkFile is unset, and no sink function is available, this method simply empties the FitsChan, and is then equivalent to AST_EMPTYFITS.

• This method attempt to execute even if an error has occurred previously.