Sets the edge chunk option in a dataset creation property list


H5P_SET_CHUNK_OPTS ( dcpl_id, opts )


<pre><code class="language-c">herr_t H5Pset_chunk_opts(
        hid_t dcpl_id,
        unsigned opts

<pre><code class="language-fortran">NONE</code></pre>

hid_t dcpl_idIN: Dataset creation property list identifier
unsigned opts

IN: Edge chunk option flag. Valid values are:


When enabled, filters are not applied to partial edge chunks.

When disabled, partial edge chunks are filtered.

Enabling this option will improve performance when appending to the dataset and, when compression filters are used, prevent reallocation of these chunks.

Datasets created with this option enabled will be inaccessible with HDF5 library versions before Release 1.10.

Default: Disabled

0 (zero)   Disables option; partial edge chunks will be compressed.


H5P_SET_CHUNK_OPTS is used to specify storage options for chunks on the edge of a dataset’s dataspace. This capability allows the user to tune performance in cases where the dataset size may not be a multiple of the chunk size and the handling of partial edge chunks can impact performance.


H5P_SET_CHUNK_OPTS sets the edge chunk option in the dataset creation property list dcpl_id.

The available option is detailed in the parameters section below. Only chunks that are not completely filled by the dataset’s dataspace are affected by this option. Such chunks are referred to as partial edge chunks.


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


Coming Soon!

Release    Change
1.10.0C function introduced with this release.