idlastro / Database Procedures: DBRD

[Source code]

NAME
DBRD
PURPOSE
procedure to read an entry from a data base file or from
linked multiple databases.
CALLING SEQUENCE
dbrd, enum, entry, [available, dbno, /NoConvert]
INPUTS
enum - entry number to read, integer scalar
OUTPUT
entry - byte array containing the entry
OPTIONAL OUTPUT
available - byte array with length equal to number of data
        bases opened.  available(i) eq 1 if an entry (pointed
        to) is available.  It always equals 1 for the first 
        data base, otherwise it is an error condition.
OPTIONAL INPUT
dbno - specification of the data base number to return.  If
        supplied, only the record for the requested data base
        number is returned in entry.  Normally this input should
        not be supplied.  dbno is numbered for 0 to n-1 and gives
        the number of the data base opened.  The data bases are 
        numbered in the order supplied to dbopen.  If dbno is supplied 
        then the entry number refers to that data base and not the
        primary or first data base. If set to -1, then it means all
        data bases opened (same as not supplying it)
OPTIONAL INPUT KEYWORD
noconvert - if set then don't convert external to host format.
        Assumes that calling program will take care of this
        requirement.
OPERATIONAL NOTES
If multiple data base files are opened, the records are
concatenated with each other
HISTORY
version 2  D. Lindler  Nov. 1987
William Thompson, GSFC/CDS (ARC), 1 June 1994
        Added support for external (IEEE) representation.
Version 3, Richard Schwartz, GSFC/SDAC, 23-Aug-1996
                Add noconvert keyword
Converted to IDL V5.0   W. Landsman   September 1997
ersion 4, 2 May 2003, W. Thompson
       Use BSWAP keyword to DBXVAL instead of calling IEEE_TO_HOST.