Welcome to the Harris Geospatial documentation center. Here you will find reference guides and help documents.


  >  Docs Center  >  Libraries  >  ASTROLIB  >  DBRD

DBRD

DBRD

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
      Version 4, 2 May 2003, W. Thompson
              Use BSWAP keyword to DBXVAL instead of calling IEEE_TO_HOST.



© 2019 Harris Geospatial Solutions, Inc. |  Legal
My Account    |    Store    |    Contact Us