IN: Identifier of the dataspace selection iterator to retrieve sequence from
IN: Max. # of sequences to retrieve
IN: Max. # of bytes to retrieve in sequences
OUT: # of sequences retrieved
OUT: # of bytes retrieved, in all sequences
OUT: Array of sequence offsets
OUT: Array of sequence lengths
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.