diff options
Diffstat (limited to 'src/H5Spkg.h')
| -rw-r--r-- | src/H5Spkg.h | 148 |
1 files changed, 102 insertions, 46 deletions
diff --git a/src/H5Spkg.h b/src/H5Spkg.h index d31d894..288fffe 100644 --- a/src/H5Spkg.h +++ b/src/H5Spkg.h @@ -96,7 +96,37 @@ typedef struct { H5S_hyper_span_info_t *span_lst; /* List of hyperslab span information */ } H5S_hyper_sel_t; -/* Selection information container */ +/* Selection information methods */ +/* Method to retrieve a list of offset/length sequences for selection */ +typedef herr_t (*H5S_sel_get_seq_list_func_t)(const H5S_t *space, unsigned flags, + H5S_sel_iter_t *iter, size_t elem_size, size_t maxseq, size_t maxbytes, + size_t *nseq, size_t *nbytes, hsize_t *off, size_t *len); +/* Method to compute number of elements in current selection */ +typedef hsize_t (*H5S_sel_get_npoints_func_t)(const H5S_t *space); +/* Method to release current selection */ +typedef herr_t (*H5S_sel_release_func_t)(H5S_t *space); +/* Method to initialize iterator for current selection */ +typedef herr_t (*H5S_sel_iter_init_func_t)(const H5S_t *space, size_t elmt_size, H5S_sel_iter_t *sel_iter); +/* Method to determine number of elements left in iterator for current selection */ +typedef hsize_t (*H5S_sel_iter_nelmts_func_t)(const H5S_sel_iter_t *iter); +/* Method to release iterator for current selection */ +typedef herr_t (*H5S_sel_iter_release_func_t)(H5S_sel_iter_t *iter); +/* Method to determine if current selection is valid for dataspace */ +typedef htri_t (*H5S_sel_is_valid_func_t)(const H5S_t *space); +/* Method to determine number of bytes required to store current selection */ +typedef hssize_t (*H5S_sel_serial_size_func_t)(const H5S_t *space); +/* Method to store current selection in "serialized" form (a byte sequence suitable for storing on disk) */ +typedef herr_t (*H5S_sel_serialize_func_t)(const H5S_t *space, uint8_t *buf); +/* Method to determine to smallest n-D bounding box containing the current selection */ +typedef herr_t (*H5S_sel_bounds_func_t)(const H5S_t *space, hsize_t *start, hsize_t *end); +/* Method to determine if current selection is contiguous */ +typedef htri_t (*H5S_sel_is_contiguous_func_t)(const H5S_t *space); +/* Method to determine if current selection is a single block */ +typedef htri_t (*H5S_sel_is_single_func_t)(const H5S_t *space); +/* Method to determine if current selection is "regular" */ +typedef htri_t (*H5S_sel_is_regular_func_t)(const H5S_t *space); + +/* Selection information object */ typedef struct { H5S_sel_type type; /* Type of selection (list of points or hyperslabs) */ hssize_t *offset; /* Offset within the extent (NULL means a 0 offset) */ @@ -106,6 +136,19 @@ typedef struct { H5S_pnt_list_t *pnt_lst; /* List of selected points (order is important) */ H5S_hyper_sel_t hslab; /* Info about new-style hyperslab selections */ } sel_info; + H5S_sel_get_seq_list_func_t get_seq_list; /* Method to retrieve a list of offset/length sequences for selection */ + H5S_sel_get_npoints_func_t get_npoints; /* Method to compute number of elements in current selection */ + H5S_sel_release_func_t release; /* Method to release current selection */ + H5S_sel_iter_init_func_t iter_init; /* Method to initialize iterator for current selection */ + H5S_sel_iter_nelmts_func_t iter_nelmts; /* Method to determine number of elements left in iterator for current selection */ + H5S_sel_iter_release_func_t iter_release; /* Method to release iterator for current selection */ + H5S_sel_is_valid_func_t is_valid; /* Method to determine if current selection is valid for dataspace */ + H5S_sel_serial_size_func_t serial_size; /* Method to determine number of bytes required to store current selection */ + H5S_sel_serialize_func_t serialize; /* Method to store current selection in "serialized" form (a byte sequence suitable for storing on disk) */ + H5S_sel_bounds_func_t bounds; /* Method to determine to smallest n-D bounding box containing the current selection */ + H5S_sel_is_contiguous_func_t is_contiguous; /* Method to determine if current selection is contiguous */ + H5S_sel_is_single_func_t is_single; /* Method to determine if current selection is a single block */ + H5S_sel_is_regular_func_t is_regular; /* Method to determine if current selection is "regular" */ } H5S_select_t; /* Main dataspace structure (typedef'd in H5Sprivate.h) */ @@ -114,76 +157,89 @@ struct H5S_t { H5S_select_t select; /* Dataspace selection */ }; +/* Extent functions */ __DLL__ herr_t H5S_close_simple(H5S_simple_t *simple); __DLL__ herr_t H5S_release_simple(H5S_simple_t *simple); __DLL__ herr_t H5S_extent_copy(H5S_extent_t *dst, const H5S_extent_t *src); /* Point select functions */ -__DLL__ herr_t H5S_point_init (const H5S_t *space, size_t elmt_size, +__DLL__ herr_t H5S_point_iter_init (const H5S_t *space, size_t elmt_size, H5S_sel_iter_t *iter); -__DLL__ hsize_t H5S_point_favail (const H5S_t *space, const H5S_sel_iter_t *iter, - hsize_t max); -__DLL__ herr_t H5S_point_add(H5S_t *space, H5S_seloper_t op, size_t num_elem, - const hssize_t **coord); +__DLL__ hsize_t H5S_point_iter_nelmts (const H5S_sel_iter_t *iter); +__DLL__ herr_t H5S_point_iter_release(H5S_sel_iter_t *sel_iter); __DLL__ herr_t H5S_point_release(H5S_t *space); __DLL__ hsize_t H5S_point_npoints(const H5S_t *space); __DLL__ herr_t H5S_point_copy(H5S_t *dst, const H5S_t *src); -__DLL__ htri_t H5S_point_select_valid(const H5S_t *space); -__DLL__ hssize_t H5S_point_select_serial_size(const H5S_t *space); -__DLL__ herr_t H5S_point_select_serialize(const H5S_t *space, uint8_t *buf); -__DLL__ herr_t H5S_point_select_deserialize(H5S_t *space, const uint8_t *buf); -__DLL__ herr_t H5S_point_bounds(H5S_t *space, hsize_t *start, hsize_t *end); -__DLL__ htri_t H5S_point_select_contiguous(const H5S_t *space); -__DLL__ htri_t H5S_point_select_single(const H5S_t *space); -__DLL__ htri_t H5S_point_select_regular(const H5S_t *space); -__DLL__ herr_t H5S_select_elements (H5S_t *space, H5S_seloper_t op, - size_t num_elem, const hssize_t **coord); -__DLL__ herr_t H5S_point_select_get_seq_list(unsigned flags, const H5S_t *space,H5S_sel_iter_t *iter, - size_t elem_size, size_t maxseq, size_t maxbytes, +__DLL__ htri_t H5S_point_is_valid(const H5S_t *space); +__DLL__ hssize_t H5S_point_serial_size(const H5S_t *space); +__DLL__ herr_t H5S_point_serialize(const H5S_t *space, uint8_t *buf); +__DLL__ herr_t H5S_point_deserialize(H5S_t *space, const uint8_t *buf); +__DLL__ herr_t H5S_point_bounds(const H5S_t *space, hsize_t *start, hsize_t *end); +__DLL__ htri_t H5S_point_is_contiguous(const H5S_t *space); +__DLL__ htri_t H5S_point_is_single(const H5S_t *space); +__DLL__ htri_t H5S_point_is_regular(const H5S_t *space); +__DLL__ herr_t H5S_point_get_seq_list(const H5S_t *space, unsigned flags, + H5S_sel_iter_t *iter, size_t elem_size, size_t maxseq, size_t maxbytes, size_t *nseq, size_t *nbytes, hsize_t *off, size_t *len); /* "All" select functions */ -__DLL__ herr_t H5S_all_init (const H5S_t *space, size_t elmt_size, +__DLL__ herr_t H5S_all_iter_init (const H5S_t *space, size_t elmt_size, H5S_sel_iter_t *iter); -__DLL__ hsize_t H5S_all_favail (const H5S_t *space, const H5S_sel_iter_t *iter, - hsize_t max); +__DLL__ hsize_t H5S_all_iter_nelmts (const H5S_sel_iter_t *iter); +__DLL__ herr_t H5S_all_iter_release(H5S_sel_iter_t *sel_iter); __DLL__ herr_t H5S_all_release(H5S_t *space); __DLL__ hsize_t H5S_all_npoints(const H5S_t *space); -__DLL__ herr_t H5S_all_select_serialize(const H5S_t *space, uint8_t *buf); -__DLL__ herr_t H5S_all_select_deserialize(H5S_t *space, const uint8_t *buf); -__DLL__ herr_t H5S_all_bounds(H5S_t *space, hsize_t *start, hsize_t *end); -__DLL__ herr_t H5S_all_select_get_seq_list(unsigned flags, const H5S_t *space,H5S_sel_iter_t *iter, - size_t elem_size, size_t maxseq, size_t maxbytes, +__DLL__ htri_t H5S_all_is_valid(const H5S_t *space); +__DLL__ hssize_t H5S_all_serial_size(const H5S_t *space); +__DLL__ herr_t H5S_all_serialize(const H5S_t *space, uint8_t *buf); +__DLL__ herr_t H5S_all_deserialize(H5S_t *space, const uint8_t *buf); +__DLL__ herr_t H5S_all_bounds(const H5S_t *space, hsize_t *start, hsize_t *end); +__DLL__ htri_t H5S_all_is_contiguous(const H5S_t *space); +__DLL__ htri_t H5S_all_is_single(const H5S_t *space); +__DLL__ htri_t H5S_all_is_regular(const H5S_t *space); +__DLL__ herr_t H5S_all_get_seq_list(const H5S_t *space, unsigned flags, + H5S_sel_iter_t *iter, size_t elem_size, size_t maxseq, size_t maxbytes, size_t *nseq, size_t *nbytes, hsize_t *off, size_t *len); /* Hyperslab selection functions */ -__DLL__ herr_t H5S_hyper_init (const H5S_t *space, size_t elmt_size, +__DLL__ herr_t H5S_hyper_iter_init (const H5S_t *space, size_t elmt_size, H5S_sel_iter_t *iter); -__DLL__ hsize_t H5S_hyper_favail (const H5S_t *space, const H5S_sel_iter_t *iter, - hsize_t max); +__DLL__ hsize_t H5S_hyper_iter_nelmts (const H5S_sel_iter_t *iter); +__DLL__ herr_t H5S_hyper_iter_release(H5S_sel_iter_t *sel_iter); __DLL__ herr_t H5S_hyper_release(H5S_t *space); -__DLL__ herr_t H5S_hyper_sel_iter_release(H5S_sel_iter_t *sel_iter); __DLL__ hsize_t H5S_hyper_npoints(const H5S_t *space); __DLL__ herr_t H5S_hyper_copy(H5S_t *dst, const H5S_t *src); -__DLL__ htri_t H5S_hyper_select_valid(const H5S_t *space); -__DLL__ hssize_t H5S_hyper_select_serial_size(const H5S_t *space); -__DLL__ herr_t H5S_hyper_select_serialize(const H5S_t *space, uint8_t *buf); -__DLL__ herr_t H5S_hyper_select_deserialize(H5S_t *space, const uint8_t *buf); -__DLL__ hssize_t H5S_hyper_span_nblocks(H5S_hyper_span_info_t *spans); -__DLL__ herr_t H5S_hyper_span_blocklist(H5S_hyper_span_info_t *spans, hssize_t start[], hssize_t end[], hsize_t rank, hsize_t *startblock, hsize_t *numblocks, hsize_t **buf); -__DLL__ herr_t H5S_hyper_bounds(H5S_t *space, hsize_t *start, hsize_t *end); -__DLL__ htri_t H5S_hyper_select_contiguous(const H5S_t *space); -__DLL__ htri_t H5S_hyper_select_single(const H5S_t *space); -__DLL__ htri_t H5S_hyper_select_regular(const H5S_t *space); -__DLL__ herr_t H5S_hyper_select_get_seq_list(unsigned flags, const H5S_t *space,H5S_sel_iter_t *iter, - size_t elem_size, size_t maxseq, size_t maxbytes, +__DLL__ htri_t H5S_hyper_is_valid(const H5S_t *space); +__DLL__ hssize_t H5S_hyper_serial_size(const H5S_t *space); +__DLL__ herr_t H5S_hyper_serialize(const H5S_t *space, uint8_t *buf); +__DLL__ herr_t H5S_hyper_deserialize(H5S_t *space, const uint8_t *buf); +__DLL__ herr_t H5S_hyper_bounds(const H5S_t *space, hsize_t *start, hsize_t *end); +__DLL__ htri_t H5S_hyper_is_contiguous(const H5S_t *space); +__DLL__ htri_t H5S_hyper_is_single(const H5S_t *space); +__DLL__ htri_t H5S_hyper_is_regular(const H5S_t *space); +__DLL__ herr_t H5S_hyper_get_seq_list(const H5S_t *space, unsigned flags, + H5S_sel_iter_t *iter, size_t elem_size, size_t maxseq, size_t maxbytes, size_t *nseq, size_t *nbytes, hsize_t *off, size_t *len); /* "None" selection functions */ +__DLL__ herr_t H5S_none_iter_init (const H5S_t *space, size_t elmt_size, + H5S_sel_iter_t *iter); +__DLL__ hsize_t H5S_none_iter_nelmts (const H5S_sel_iter_t *iter); +__DLL__ herr_t H5S_none_iter_release(H5S_sel_iter_t *sel_iter); +__DLL__ herr_t H5S_none_release(H5S_t *space); +__DLL__ hsize_t H5S_none_npoints(const H5S_t *space); +__DLL__ htri_t H5S_none_is_valid(const H5S_t *space); +__DLL__ hssize_t H5S_none_serial_size(const H5S_t *space); +__DLL__ herr_t H5S_none_serialize(const H5S_t *space, uint8_t *buf); +__DLL__ herr_t H5S_none_deserialize(H5S_t *space, const uint8_t *buf); +__DLL__ herr_t H5S_none_bounds(const H5S_t *space, hsize_t *start, hsize_t *end); +__DLL__ htri_t H5S_none_is_contiguous(const H5S_t *space); +__DLL__ htri_t H5S_none_is_single(const H5S_t *space); +__DLL__ htri_t H5S_none_is_regular(const H5S_t *space); +__DLL__ herr_t H5S_none_get_seq_list(const H5S_t *space, unsigned flags, + H5S_sel_iter_t *iter, size_t elem_size, size_t maxseq, size_t maxbytes, + size_t *nseq, size_t *nbytes, hsize_t *off, size_t *len); +/* Needed for use in hyperslab code (H5Shyper.c) */ __DLL__ herr_t H5S_select_none(H5S_t *space); -__DLL__ herr_t H5S_none_select_serialize(const H5S_t *space, uint8_t *buf); -__DLL__ herr_t H5S_none_select_deserialize(H5S_t *space, const uint8_t *buf); -__DLL__ herr_t H5S_none_select_iterate(void *buf, hid_t type_id, H5S_t *space, - H5D_operator_t op, void *operator_data); #endif |