idlastro / FITS Binary Table Extensions I/O: FXBPARSE

[Source code]

NAME
FXBPARSE
Purpose
Parse the binary table extension header.
Explanation
Parses the binary table extension header, and store the information
about the format of the binary table in the FXBINTABLE common
block--called from FXBCREATE and FXBOPEN.
Use
FXBPARSE, ILUN, UNIT, HEADER
Inputs
ILUN    = Index into the arrays in the FXBINTABLE common block.
HEADER  = FITS binary table extension header.
Opt. Inputs
None.
Outputs
None.
Opt. Outputs
None.
Keywords
NO_TDIM   = If set, then any TDIMn keywords found in the header are
            ignored.
ERRMSG    = If defined and passed, then any error messages will be
            returned to the user in this parameter rather than
            depending on the MESSAGE routine in IDL.  If no errors are
            encountered, then a null string is returned.  In order to
            use this feature, ERRMSG must be defined first, e.g.
                ERRMSG = ''
                FXBPARSE, ERRMSG=ERRMSG, ...
                IF ERRMSG NE '' THEN ...
Calls
FXBFIND, FXBTDIM, FXBTFORM, FXPAR
Common
Uses common block FXBINTABLE--see "fxbintable.pro" for more
information.
Restrictions
None.
Side effects
Any TDIMn keywords found for bit arrays (format 'X') are ignored, since
the dimensions would refer to bits, not bytes.
Category
Data Handling, I/O, FITS, Generic.
Prev. Hist.
William Thompson, Feb. 1992.
William Thompson, Jan. 1993, modified for renamed FXBTFORM and FXBTDIM.
Written
William Thompson, GSFC, February 1992.
Modified
Version 1, William Thompson, GSFC, 12 April 1993.
        Incorporated into CDS library.
Version 2, William Thompson, GSFC, 21 June 1994
        Added ERRMSG keyword.
ersion 3, William Thompson, GSFC, 23 June 1994
       Modified so that ERRMSG is not touched if not defined.
Version 4, Michael Schubnell, University of Michigan, 22 May 1996
        Change N_DIMS from short to long integer.
Version 5, W. Landsman, GSFC, 12 Aug 1997
        Use double complex datatype, if needed
Version 6, W. Landsman GSFC 30 Aug 1997
ptimized FXPAR; call FXBFIND for speed, CM 1999 Nov 18
odify DHEAP(ILUN) when opening table now, CM 2000 Feb 22
efault the TZERO/TSCAL tables to double instead of single
 precision floating point, CM 2003 Nov 23
ake NAXIS1 and NAXIS2 64-bit integers to deal with large files,
 E. Hivon Mar 2008
emove use of Obsolete !ERR system variable
n 
ersion 8   April 2010