Overwrites records

Procedure:

H5TB_WRITE_RECORDS (loc_id, table_name, start, nrecords, type_size, field_offset, field_Sizes, data )

Signature:

<pre><code class="language-c">herr_t H5TBwrite_records ( 
            hid_t loc_id, 
            const char *table_name, 
            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>

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
hsize_t startIN: The zero 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_offset

IN: 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
const void *dataIN: Buffer with data

Description:

H5TB_WRITE_RECORDS overwrites records starting at the zero index position start of the table 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: