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

Procedure:

H5TB_READ_FIELDS_NAME ( loc_id, table_name, field_names, start, nrecords, type_size, field_offset, dst_sizes, data)

Signature:

<pre><code class="language-c">herr_t H5TBread_fields_name ( hid_t loc_id, const char *table_name, 
             const char * field_names, hsize_t start, hsize_t nrecords, size_t type_size,  const size_t *field_offset, 
             const size_t *dst_sizes, void *data )</code></pre>

<pre><code class="language-fortran">subroutine h5tbread_field_name_f(loc_id, dset_name, field_name, 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 
  character(LEN=*), intent(IN) :: field_name     ! name of the field
  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_name_f</code></pre>

Parameters:
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
const char * field_namesIN: An array containing the names 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_size

IN: 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

Description:

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

Returns:

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

Example: