AST_PUTTABLES

Store one or more FitsTables in a FitsChan

Description:

This routine allows representations of one or more FITS binary tables to be stored in a FitsChan. For instance, these may provide the coordinate look-up tables needed subequently when reading FITS-WCS headers for axes described using the " -TAB" algorithm. Since, in general, the calling application may not know which tables will be needed - if any - prior to calling AST_READ, the AST_TABLESOURCE routine provides an alternative mechanism in which a caller-supplied function is invoked to store a named table in the FitsChan.

Invocation

CALL AST_PUTTABLES( THIS, TABLES, STATUS )

Arguments

THIS = INTEGER (Given)
Pointer to the FitsChan.
TABLES = INTEGER (Given)
Pointer to a KeyMap holding the tables that are to be added to the FitsChan. Each entry should hold a scalar value which is a pointer to a FitsTable to be added to the FitsChan. Any unusable entries are ignored. The key associated with each entry should be the name of the FITS binary extension from which the table was read. If a FitsTable with the associated key already exists in the FitsChan, it is replaced with the new one. A deep copy of each usable FitsTable is stored in the FitsChan, so any subsequent changes made to the FitsTables will have no effect on the behaviour of the FitsChan.
STATUS = INTEGER (Given and Returned)
The global status.

Notes:

• Tables stored in the FitsChan may be retrieved using AST_GETTABLES.

• The tables in the supplied KeyMap are added to any tables already in the FitsChan.

• The AST_PUTTABLE method provides a simpler means of adding a single table to a FitsChan.