Adds records to the end of the table

Procedure:

H5TB_APPEND_RECORDS (loc_id, dset_name, nrecords, type_size, field_offset, field_sizes, data )

Signature:

<pre><code class="language-c">herr_t H5TBappend_records ( hid_t loc_id, const char *dset_name, 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 *dset_nameIN: The name of the dataset to overwrite
hsize_t nrecordsIN: The number of records to append
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
const void *dataIN: Buffer with data

Description:

H5TB_APPEND_RECORDS adds records to the end of the table named dset_name attached to the object specified by the identifier loc_id. The dataset is extended to hold the new records.

Returns:

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

Example: