Retrieves number of chunks that have nonempty intersection with a specified selection
Procedure:
H5D_GET_NUM_CHUNKS (dset_id, fspace_id, nchunks)
Signature:
herr_t H5Dget_num_chunks(hid_t dset_id, hid_t fspace_id, hsize_t *nchunks)
Parameters:
hid_t dset_id | IN: Dataset identifier |
hid_t fspace_id | IN: File dataspace selection identifier; H5S_ALL if the selection is the current extent of the dataset (See NOTE below)
|
hsize_t * nchunks | IN/OUT: Number of chunks in the selection |
Description:
H5D_GET_NUM_CHUNKS retrieves the number of chunks nchunks in a set of selected elements specified by fspace_id for a dataset specified by the identifier dset_id. If fspace_id is H5S_ALL, the function will retrieve the total number of chunks stored for the dataset.
NOTE: Please be aware that in the HDF5-1.10.5 release, the file space identifier does not (yet) support non-trivial selections. The implementation also does not currently support the H5S_ALL macro. As a workaround, get the dataspace for the dataset (H5D_GET_SPACE), select all elements in the dataspace (H5S_SELECT_ALL) and pass that in for fspace_id.
Returns:
Returns a non-negative value if successful. Otherwise returns a negative value.
Example:
History:
| Release | Change |
|---|
| 1.10.5 | C function introduced |
--- Last Modified: March 06, 2019 | 10:59 AM
