astPutTablesastPutTables - Store one or more FitsTables in a FitsChan

Description:
This function allows representations of one or more FITS binary tables to be stored in a FitsChanFitsChan. 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 astReadastRead, the astTablesSource function provides an alternative mechanism in which a caller-supplied function is invoked to store a named table in the FitsChan.
Synopsis:
void astPutTables( AstFitsChan $*$this, AstKeyMap $*$tables )
Parameters:
this
Pointer to the FitsChan.
tables
Pointer to a KeyMapKeyMap holding the tables that are to be added to the FitsChan. Each entry should hold a scalar value which is a pointer to a FitsTableFitsTable 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.
Notes:
  • Tables stored in the FitsChan may be retrieved using astGetTablesastGetTables.

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

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