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


  >  Docs Center  >  Libraries  >  ASTROLIB  >  DBEXT_DBF

DBEXT_DBF

DBEXT_DBF

Name


      DBEXT_DBF

Purpose


      Subroutine of DBEXT to extract values of up to 18 items from a database

Explanation


      This is a subroutine of DBEXT, which is the routine a user should
      normally use.

Calling Sequence


      dbext_dbf,list,dbno,sbyte,nbytes,idltype,nval,v1,[ v2,v3,v4,v5,v6,v7,
                  v8,v9,v10,v11,v12,v13,v14,v15,v16,v17,v18 ITEM_DBNO = ]

Inputs


      list - list of entry numbers to extract desired items. It is the
              entry numbers in the primary data base unless dbno is greater
              than or equal to -1. In that case it is the entry number in
              the specified data base.
      dbno - number of the opened db file
              if set to -1 then all data bases are included
      sbyte - starting byte in the entry. If single data base then it must
              be the starting byte for that data base only and not the
              concatenation of db records
      nbytes - number of bytes in the entry
      idltype - idl data type of each item to be extracted
      nval - number of values per entry of each item to be extracted

Outputs


      v1...v18 - the vectors of values for up to 18 items

Optional Input Keyword


      item_dbno - A vector of the individual database numbers for each item.
              Simplifies the code for linked databases

Procedure Calls


      DB_INFO(), DB_ITEM_INFO(), DBRD, DBXVAL(), IS_IEEE_BIG(), IEEE_TO_HOST

History


      version 1 D. Lindler Nov. 1987
      Extract multiple valued entries W. Landsman May 1989
      William Thompson, GSFC/CDS (ARC), 1 June 1994
              Added support for external (IEEE) representation.
      Work with multiple element string items W. Landsman August 1995
      Increase speed for external databases on IEEE machines WBL August 1996
      IEEE conversion implemented on blocks of entries using BIG
      Added keyword ITEM_DBNO R. Schwartz, GSFC/SDAC, August 1996
      Return a vector even if only 1 value W. Thompson October 1996
      Change variable name of BYTESWAP to BSWAP W. Thompson Mar 1997
      Use /OVERWRITE with reform W. Landsman May 1997
      Increase maximum number of items to 18 W. Landsman November 1999
      2 May 2003, W. Thompson, Use DBXVAL with BSWAP instead of IEEE_TO_HOST.
      Avoid EXECUTE() for V6.1 or later W. Landsman Jan 2007
      Assume since V6.1 W. Landsman June 2009
      Change arrays to LONG to support entries >32767 bytes WL Oct 2010



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