H5S_SEL_ITER_GET_SEQ_LIST
Retrieves a list of offset / length sequences for the elements in an iterator
Procedure:
H5S_SEL_ITER_GET_SEQ_LIST ( sel_iter_id, maxseq, maxbytes, nseq, nbytes, off, len )
Signature:
herr_t H5Ssel_iter_get_seq_list ( hid_t sel_iter_id, size_t maxseq, size_t maxbytes,
size_t *nseq, size_t *nbytes, hsize_t *off, size_t *len )
Parameters:
hid_t sel_iter_id | IN: Identifier of the dataspace selection iterator to retrieve sequence from |
size_t maxseq | IN: Max. # of sequences to retrieve |
size_t maxbytes | IN: Max. # of bytes to retrieve in sequences |
size_t *nseq | OUT: # of sequences retrieved |
size_t *nbytes | OUT: # of bytes retrieved, in all sequences |
hsize_t *off | OUT: Array of sequence offsets |
size_t *len | OUT: Array of sequence lengths |
Description:
H5S_SEL_ITER_GET_SEQ_LIST retrieves a list of offset / length pairs (a list of "sequences") matching the selected elements for an iterator sel_iter_id, according to the iteration order for the iterator. The lengths returned are in bytes, not elements.
Note that the iteration order for "all" and "hyperslab" selections is row-major (i.e. "C-ordered"), but the iteration order for "point" selections is "in order selected", unless the H5S_SEL_ITER_GET_SEQ_LIST_SORTED flag is passed to H5S_SEL_ITER_CREATE for a point selection.
maxseq and maxbytes specify the most sequences or bytes possible to place into the off and len arrays. *nseq and *nbytes return the actual number of sequences and bytes put into the arrays.
Each call to H5S_SEL_ITER_GET_SEQ_LIST will retrieve the next set of sequences for the selection being iterated over.
The total number of bytes possible to retrieve from a selection iterator is the elmt_size passed to H5S_SEL_ITER_CREATE multiplied by the number of elements selected in the dataspace the iterator was created from (which can be retrieved with H5S_GET_SELECT_NPOINTS). When there are no further sequences of elements to retrieve, calls to this routine will set *nseq and *nbytes to zero.
Returns:
Non-negative on success / Negative on failure
Example:
Include Bitbucket Server for Confluence: An error occured
Connection to Bitbucket Server could not be established. Verify that you have properly configured the Bitbucket Server application link for your Confluence space and that your Bitbucket Server instance is up and running. Error details: javax.net.ssl.SSLHandshakeException: sun.security.validator.ValidatorException: PKIX path building failed: sun.security.provider.certpath.SunCertPathBuilderException: unable to find valid certification path to requested target
History:
| Release | Change |
|---|
| 1.12.0 | Function introduced in this release. |
--- Last Modified: December 16, 2019 | 02:30 PM
