idlastro / FITS Binary Table Extensions I/O: FXBFINISH

[Source code]

NAME
FXBFINISH
Purpose
Close a FITS binary table extension file opened for write.
Explanation
Closes a FITS binary table extension file that had been opened for
write by FXBCREATE.
Use
FXBFINISH, UNIT
Inputs
UNIT    = Logical unit number of the file.
Opt. Inputs
None.
Outputs
None.
Opt. Outputs
None.
Keywords
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 = ''
                FXBFINISH, ERRMSG=ERRMSG, ...
                IF ERRMSG NE '' THEN ...
Calls
None.
Common
Uses common block FXBINTABLE--see "fxbintable.pro" for more
information.
Restrictions
The file must have been opened with FXBCREATE, and written with
FXBWRITE.
Side effects
Any bytes needed to pad the file out to an integral multiple of 2880
bytes are written out to the file.  Then, the file is closed.
Category
Data Handling, I/O, FITS, Generic.
Prev. Hist.
W. Thompson, Jan 1992.
W. Thompson, Feb 1992, modified to support variable length arrays.
W. Thompson, Feb 1992, removed all references to temporary files.
Written
William Thompson, GSFC, January 1992.
Modified
Version 1, William Thompson, GSFC, 12 April 1993.
        Incorporated into CDS library.
Version 2, William Thompson, GSFC, 21 July 1993.
        Fixed bug with variable length arrays.
Version 3, William Thompson, GSFC, 31 May 1994
        Added ERRMSG keyword.
ersion 4, William Thompson, GSFC, 23 June 1994
       Modified so that ERRMSG is not touched if not defined.
Version
Version 4, 23 June 1994
 Converted to IDL V5.0   W. Landsman   September 1997