H5TBread_fields_index

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)

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.

synopsis:Reads one or several fields. The fields are identified by index.
param loc_id:IN: Identifier of the file or group to read the table within.
param table_name:
 IN: The name of the dataset to read.
param nfields:IN: The number of fields to overwrite. This parameter is also the size of the field_index array.
param field_index:
 IN: The indexes of the fields to write.
param start:IN: The start record to read from.
param nrecords:IN: The number of records to read.
param type_size:
 IN: The size in bytes of the structure associated with the table. This value is obtained with sizeof.
param field_offset:
 IN: An array containing the offsets of the fields.
param dst_sizes:
 IN: An array containing the size in bytes of the fields.
param data:OUT: Buffer with data.
return:Returns a non-negative value if successful; otherwise returns a negative value.

Fortran90 Interface: h5tbread_field_index_f

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
  <TYPE>, intent(IN), dimension(*) :: buf        ! data buffer
  integer :: errcode                             ! error code
end subroutine h5tbread_field_index_f