CVG_BT2FT

Creates an AST FitsTable from a FITS binary table

Description:

This function creates a new AST FitsTable object holding the data read from a FITS binary table held in a named extension of the supplied FITS file.

Invocation

CALL CVG_BT2FT( FUNIT, EXTNAM, EXTVER, EXTLEVEL, TABLE, STATUS )

Arguments

FUNIT = INTEGER (Given)
The FITSIO unit number for the FITS file.
EXTNAM = CHARACTER ∗ ( ∗ ) (Given)
The name of the FITS extension containing the required binary table.
EXTVER = INTEGER (Given)
The value of the EXTVER keyword in the required binary-table HDU.
EXTLEVEL = INTEGER (Given)
The value of the EXTLEVEL keyword in the required binary-table HDU.
TABLE = INTEGER (Returned)
A pointer to the new FitsTable. A value of AST__NULL is returned (without error) if the named extension cannot be found.
STATUS = INTEGER (Given and Returned)
The global status.