Reads records.

Procedure:

H5TB_READ_RECORDS(loc_id, table_name, start, nrecords, type_size, field_offset, dst_sizes, data)

Signature:

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

Parameters:

hid_t loc_id

    IN: Identifier of the file or group to read the table within.

const char *table_name

    IN: The name of the dataset to read.

hsize_t  start

    IN: The start record to read from.

hsize_t nrecords

    IN: The number of records to read.

size_t type_size

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

    IN: An array containing the size in bytes of the fields.

void *data

    OUT: Buffer with data.

Description:

H5TBread_records reads some records identified 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:

Coming Soon!