Page tree









Reads one or several fields. The fields are identified by index




H5TB_READ_FIELDS_INDEX ( loc_id, table_name, nfields, field_index, start, nrecords, type_size, field_offset, dst_sizes, data )


 herr_t H5TBread_fields_index ( hid_t loc_id, const char *table_name, 
            int nfields, const int *field_index, hsize_t start, hsize_t nrecords, size_t type_size,  
            const size_t *field_offset, const size_t *dst_sizes, void *data)

subroutine h5tbread_field_index_f(loc_id, dset_name, field_index, start, & 
                                  nrecords, type_size, buf, errcode) 
  implicit none
  integer(HID_T), intent(IN) :: loc_id           ! file or group identifier 
  character(LEN=*), intent(IN) :: dset_name      ! name of the dataset 
  integer, intent(IN) :: field_index             ! index
  integer(HSIZE_T), intent(IN) :: start          ! start record 
  integer(HSIZE_T), intent(IN) :: nrecords       ! records
  integer(SIZE_T), intent(IN) :: type_size       ! type size
  , intent(IN), dimension(*) :: buf        ! data buffer 
  integer :: errcode                             ! error code
end subroutine h5tbread_field_index_f

hid_t loc_idIN: Identifier of the file or group to read the table within
const char *table_nameIN: The name of the dataset to read
int nfieldsIN: The number of fields to read (This parameter is also the size of the field_index array.)
const int * field_indexIN: The indexes of the fields to read
hsize_t  startIN: The start record to read from
hsize_t nrecordsIN: The number of records to read
hsize_t type_sizeIN: The size in bytes of the structure associated with the table. (This value is obtained with sizeof.)
const size_t *field_offsetIN: An array containing the offsets of the fields
const size_t *dst_sizesIN: An array containing the size in bytes of the fields
void *dataOUT: Buffer with data


H5TB_READ_FIELDS_INDEX reads the fields identified by  field_index from a dataset named table_name attached to the object specified by the identifier loc_id


Returns a non-negative value if successful; otherwise returns a negative value.


hl / test / test_table.c [1337:1343]
 1.10/master  HDFFV/hdf5  Copy
        /* read back the all table */
        nfields  = 5;
        start    = 0;
        nrecords = NRECORDS;
        if ( H5TBread_fields_index(fid, "table11", nfields, field_index,
            start, nrecords, type_size_mem, field_offset, field_size, rbuf ) < 0 )
            goto out;

--- Last Modified: January 15, 2020 | 01:21 PM