Resets a packet table's index to the first packet.

Procedure:

H5PT_CREATE_INDEX(table_id)

Signature:

<pre><code class="language-c">herr_t H5PTcreate_index(hid_t table_id)</code></pre>

Parameters:

hid_t table_id

    IN: Identifier of packet table whose index should be initialized.

Description:

Each packet table keeps an index of the "current" packet so that get_next can iterate through the packets in order. H5PTcreate_index initializes a packet table's index, and should be called before using get_next. The index must be initialized every time a packet table is created or opened; this information is lost when the packet table is closed.

Returns:

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

Example:

Coming Soon!