Overwrites fields

Procedure:

H5TB_WRITE_FIELDS_INDEX (loc_id, table_name, nfields, field_index, start, nrecords, type_size, field_offset, field_sizes, data )

Signature:

<pre><code class="language-c">herr_t H5TBwrite_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* field_sizes, 
              const void *data
         )</code></pre>

<pre><code class="language-fortran">subroutine h5tbwrite_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 h5tbwrite_field_index_f</code></pre>

Parameters:
hid_t loc_idIN: Identifier of the file or group where the table is located
const char *table_nameIN: The name of the dataset to overwrite
int nfieldsIN: The number of fields to overwrite. This parameter is also the size of the field_index array.
const int *field_indexIN: The indexes of the fields to write
hsize_t startIN: The zero based index record to start writing
hsize_t nrecordsIN: The number of records to write
size_t type_sizeIN: The size of the structure type, as calculated by sizeof()
const size_t *field_offsetIN: An array containing the offsets of the fields. These offsets can be calculated with the HOFFSET macro.
const size_t *field_sizesIN: An array containing the sizes of the fields
void *dataIN: Buffer with data

Description:

H5TB_WRITE_FIELDS_INDEX overwrites one or several fields specified by field_index with a buffer data 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:

Please see Tables for Fortran programming hints.