c_getbdf - Retrieves a specific field from a band-dependent record

SYNTAX

#include "las.h"

FUNCTION c_getbdf (bddr, key, value)

     struct BDDR          *bddr;
     long                 *key;
     unsigned char        *value;

PARAMETERS

bddr (input, BDDR)

A BDDR structure or a FORTRAN integer array dimensioned to BDRLEN. It contains the fields of the band record of the DDR.

key (input, integer)

A constant used to designate the field of the DDR that will be returned in the argument value. The constants are shown below.

          DDBAND -- Band number 
          DDMMV  -- Min/max validity flag 
          DDMIN  -- Minimum value 
          DDMAX  -- Maximum value 
          DDSRC  -- Source 
          DDINST -- Instrument 
          DDDIR  -- Direction 
          DDCDAT -- Capture date 
          DDCTIM -- Capture time

value (output, character, length(*))

The value of bddr that corresponds to key. It should consist of the same data type and length as the field of bddr that is needed.

DESCRIPTION

The c_getbdf() call is used to return the key field of the band-dependent record bddr.

RETURN VALUE

c_getbdf() returns

     E_SUCC (0)  --> successful completion 
     E_FAIL (-1) --> operation failed