BDI_GET
Get the named items with the specified type and dimensions
Invocation
CALL BDI_GET( ID, ITEMS, TYPE, NDIM, DIMX, DATA, DIMS, STATUS )
Description
Retrieves the items specified by the ITEMS string with the specified
TYPE. Should only be used for numeric items.
Arguments
-
ID = INTEGER (given)
ADI identifier of BinDS, Array or Scalar object, or derivatives
thereof
-
ITEMS = CHARACTER*(*) (given)
List of items to be mapped
-
TYPE = CHARACTER*(*) (given)
The type with which access mapping will be performed
-
NDIM = INTEGER (given)
The dimensionality of the users data buffer
-
DIMX[NDIM] = INTEGER (ggiven)
The dimensions of the users buffer
-
DATA[] = varies (returned)
The returned data
-
DIMS[] = INTEGER (returned)
The actual sizes of the data written the users buffer
-
STATUS = INTEGER (given and returned)
The global status.
References
BDI_GET1
Get the named item as an ADI object
Invocation
CALL BDI_GET1( ID, LID, ITEM, IMODE, DID, STATUS )
Description
Retrieves the item specified by the ITEM string as an ADI object.
The behaviour when the item does not exist is controlled by IMODE.
With a value of zero BDI_GET1 will try to invent replacement data
and if it cannot will report an error. If IMODE is one then a
missing item results in an error. If IMODE is two then no error
is reported, but DID is set to ADI__NULLID.
Arguments
-
ID = INTEGER (given)
ADI identifier of BinDS, Array or Scalar object, or derivatives
thereof
-
LID = INTEGER (given)
Object ID is linked to
-
ITEM = CHARACTER*(*) (given)
Single item to be retrieved
-
IMODE = INTEGER (given)
How to handle missing items (see above)
-
DID = INTEGER (returned)
The ADI object containing the item data
-
STATUS = INTEGER (given and returned)
The global status.
References