astPutTableastPutTable
-
Store a single FitsTable in a FitsChan
- Description:
- This function
allows a representation of a single FITS binary table to be
stored in a FitsChanFitsChan. For instance, this 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 astPutTable( AstFitsChan
this, AstFitsTable
table,
const char
extnam )
- Parameters:
-
this
-
Pointer to the FitsChan.
-
table
-
Pointer to a FitsTableFitsTable to be added to the FitsChan. If a FitsTable
with the associated extension name already exists in the FitsChan,
it is replaced with the new one. A deep copy of the FitsTable is
stored in the FitsChan, so any subsequent changes made to the
FitsTable will have no effect on the behaviour of the FitsChan.
-
extnam
-
The name of the FITS extension associated with the table.
- Notes:
- Tables stored in the FitsChan may be retrieved using
astGetTablesastGetTables.
- The astPutTablesastPutTables method can add multiple FitsTables in a single call.