Page tree

The license could not be verified: License Certificate has expired!









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_id

    IN: Identifier of the file or group to read the table within.

const char *table_name

    IN: The name of the dataset to read.

int nfields

    IN: The number of fields to overwrite. This parameter is also the size of the field_index array.

const int * field_index

    IN: The indexes of the fields to write.

hsize_t  start

    IN: The start record to read from.

hsize_t nrecords

    IN: The number of records to read.

hsize_t type_size

    IN: The size in bytes of the structure associated with the table. This value is obtained with sizeof.

const size_t *field_offset

    IN: An array containing the offsets of the fields.

const size_t *dst_sizes

    IN: An array containing the size in bytes of the fields.

void *data

    OUT: Buffer with data.


H5TBread_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.


Coming Soon!

--- Last Modified: December 04, 2017 | 07:22 AM