idlastro / FITS Binary Table Extensions I/O: FXBWRITE

[Source code]

NAME
FXBWRITE
Purpose
Write a binary data array to a disk FITS binary table file.
Explanation
Each call to FXBWRITE will write to the data file, which should already
have been created and opened by FXBCREATE.  One needs to call this
routine for every column and every row in the binary table.  FXBFINISH
will then close the file.
Use
FXBWRITE, UNIT, DATA, COL, ROW
Inputs
UNIT    = Logical unit number corresponding to the file containing the
          binary table.
DATA    = IDL data array to be written to the file.
COL     = Column in the binary table to place data in, starting from
          column one.
ROW     = Row in the binary table to place data in, starting from row
          one.
Opt. Inputs
None.
Outputs
None.
Opt. Outputs
None.
Keywords
BIT     = Number of bits in bit mask arrays (type "X").  Only used if
          the column is of variable size.
NANVALUE= Value signalling data dropout.  All points corresponding to
          this value are set to be IEEE NaN (not-a-number).  Ignored
          unless DATA is of type float, double-precision or complex.
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 = ''
                FXBWRITE, ERRMSG=ERRMSG, ...
                IF ERRMSG NE '' THEN ...
Calls
None.
Common
Uses common block FXBINTABLE--see "fxbintable.pro" for more
information.
Restrictions
The binary table file must have been opened with FXBCREATE.
The data must be consistent with the column definition in the binary
table header.
The row number must be consistent with the number of rows stored in the
binary table header.
Side effects
None.
Category
Data Handling, I/O, FITS, Generic.
Prev. Hist.
W. Thompson, Jan 1992, based on WRITEFITS by J. Woffard and W. Landsman.
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 5, Wayne Landsman, GSFC, 12 Aug 1997
        Recognize IDL double complex data type
Version 6, Converted to IDL V5.0   W. Landsman   September 1997
ersion 7, William Thompson, 18-May-2016, change POINTER to ULONG
Version
Version 7, 18-May-2016