H5TBwrite_fields_index

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)

H5TBwrite_fields_index overwrites one or several fields contained in the buffer field_index from a dataset named table_name attached to the object specified by the identifier loc_id.

Synopsis:

Overwrites fields.

Parameters:
  • loc_id – IN: Identifier of the file or group where the table is located.
  • table_name – IN: The name of the dataset to overwrite.
  • nfields – IN: The number of fields to overwrite. This parameter is also the size of the field_index array.
  • field_index – IN: The indexes of the fields to write.
  • start – IN: The zero based index record to start writing.
  • nrecords – IN: The number of records to write.
  • type_size – IN: The size of the structure type, as calculated by sizeof().
  • field_offset – IN: An array containing the offsets of the fields. These offsets can be calculated with the HOFFSET macro.
  • field_sizes – IN: An array containing the sizes of the fields.
  • data – IN: Buffer with data.
Returns:

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

Fortran90 Interface: h5tbwrite_field_index_f

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