FXBFIND

       Find column keywords in a FITS binary table header.

       Finds the value of a column keyword for all the columns in the binary
       table for which it is set.  For example,
               FXBFIND, UNIT, 'TTYPE', COLUMNS, VALUES, N_FOUND
       Would find all instances of the keywords TTYPE1, TTYPE2, etc.  The
       array COLUMNS would contain the column numbers for which a TTYPEn
       keyword was found, and VALUES would contain the values.  N_FOUND would
       contain the total number of instances found.

       FXBFIND, [UNIT or HEADER], KEYWORD, COLUMNS, VALUES, N_FOUND
               [, DEFAULT ]

       Either UNIT or HEADER must be passed.
       UNIT    = Logical unit number of file opened by FXBOPEN.
       HEADER  = FITS binary table header.
       KEYWORD = Prefix to a series of FITS binary table column keywords.  The
                 keywords to be searched for are formed by combining this
                 prefix with the numbers 1 through the value of TFIELDS in the
                 header.

       DEFAULT = Default value to use for any column keywords that aren't
                 found.  If passed, then COLUMNS and VALUES will contain
                 entries for every column.  Otherwise, COLUMNS and VALUES only
                 contain entries for columns where values were found.

       COLUMNS = Array containing the column numbers for which values of the
                 requested keyword series were found.
       VALUES  = Array containing the found values.
       N_FOUND = Number of values found.  The value of this parameter is
                 unaffected by whether or not DEFAULT is passed.

       None.

      COMMENTS = Comments associated with each keyword, if any

       FXBFINDLUN, FXPAR

       Uses common block FXBINTABLE--see "fxbintable.pro" for more
       information.

       If UNIT is passed, then the file must have been opened with FXBOPEN.
       If HEADER is passed, then it must be a legal FITS binary table header.
       The type of DEFAULT must be consistent with the values of the requested
       keywords, i.e. both most be either of string or numerical type.
       The KEYWORD prefix must not have more than five characters to leave
       room for the three digits allowed for the column numbers.

       None.

       Data Handling, I/O, FITS, Generic.

       William Thompson, Feb. 1992.

       William Thompson, GSFC, February 1992.

       Version 1, William Thompson, GSFC, 12 April 1993.
               Incorporated into CDS library.

       Version 1, 12 April 1993.
       Vectorized implementation improves performance, CM 18 Nov 1999
       Added COMMENTS keyword CM Nov 2003

[Home Page] [Software, Documentation] [IDL Documentation] [Quick Reference] [Feedback]