Previous: FITS ASCII and Binary Table Data I/O Subroutines
Up: FITS ASCII and Binary Table Data I/O Subroutines
Next: Low-Level Table Access Subroutines
Previous Page: FITS ASCII and Binary Table Data I/O Subroutines
Next Page: Low-Level Table Access Subroutines

Column Information Subroutines

1
Get the table column number corresponding to a table column name where the name is defined by the TTYPEnnn keyword. If EXACT = .true. then the column name match will be case-sensitive.

FTGCNO(unit,exact,colname, > colnum,status)

2
Get information about an existing ASCII table column. (NOTE: TSCAL and TZERO must be declared as Double Precision variables). All the returned parameters are scalar quantities.

FTGACL(unit,colnum, >
               ttype,tbcol,tunit,tform,tscal,tzero,snull,tdisp,status)

3
Get information about an existing binary table column. (NOTE: TSCAL and TZERO must be declared as Double Precision variables). DATATYPE is a character string which returns the datatype of the column as defined by the TFORMn keyword (e.g., 'I', 'J','E', 'D', etc.). In the case of an ASCII character column, DATATYPE will have a value of the form 'An' where 'n' is an integer expressing the width of the field in characters. For example, if TFORM = '160A8' then FTGBCL will return DATATYPE='A8' and REPEAT=20. All the returned parameters are scalar quantities.

FTGBCL(unit,colnum, >
               ttype,tunit,datatype,repeat,tscal,tzero,tnull,tdisp,status)

4
Put (append) a TDIMnnn keyword whose value has the form '(l,m,n...)' where l, m, n... are the dimensions of a multidimension array column in a binary table.

FTPTDM(unit,colnum,naxis,naxes, > status)

5
Return the number of and size of the dimensions of a table column. Normally this information is given by the TDIMnnn keyword, but if this keyword is not present then this routine returns NAXIS = 1 and NAXES(1) equal to the repeat count in the TFORM keyword.

FTGTDM(unit,colnum,maxdim, > naxis,naxes,status)

asterix@space.starlink
Wed Feb 16 08:18:45 GMT 1994