mcf_db_get_set_att — Get dataset attributes (Fortran API)
subroutine mcf_db_get_set_att(handle,name,type,ndim,dims, size,dsize,faddr,status) subroutine mcf_db_get_set_att_type(handle,name,type,status) subroutine mcf_db_get_set_att_dims(handle,name,ndim,dims,status) subroutine mcf_db_get_set_att_size(handle,name,size,status) subroutine mcf_db_get_set_att_dsize(handle,name,dsize,status) subroutine mcf_db_get_set_att_address(handle,name,faddr,status) integer*4 handle character*(*) name character*4 type integer*4 ndim integer*8 dims(ndim) integer*8 size integer*8 dsize integer*8 faddr integer*4 status
The mcf_db_get_set_att
functions check if
a sets exists anf if so, they return the dataset attributes of a
dataset name
identified by
handle
. mcf_db_get_set_att
returns all attributes. The other functions return one attribute at
the time. Note that the functions
mcf_db_get_set_att
never abort, i.e if the set
is not found the status 1 is returned and the output values remain
undefined.
handle
Handle of database file on which the set(s) reside (input).
name
Name of dataset (input). The string may not exceed the maximum dataset name length.
Dataset type (output). The dataset type must consist of a character*4 buffer.
Number of dimensions of dataset (output).
Size of each of the ndim
dimensions
(output).
Total size of dataset (output).
size
is equal to the sum of all
dims
.
Size of descriptor in bytes (output). A value of 0 means that no descriptor is defined.
Byte start address on database file of the data of
dataset name
. Byte addresses start with
0.
status
Status code returned (output). Upon successful completion of the operation, the status value 0 is returned. If the set was not found 1 is returned (no abort).