diff options
author | Binh-Minh Ribler <bmribler@hdfgroup.org> | 2004-08-20 04:35:18 (GMT) |
---|---|---|
committer | Binh-Minh Ribler <bmribler@hdfgroup.org> | 2004-08-20 04:35:18 (GMT) |
commit | 824ba5e2fde476934df42284271c358b14e1a6af (patch) | |
tree | caf62890a1527b0fdc2a77a550c7e11f30c48584 /c++/src/H5DataSpace.h | |
parent | b142a4144862b22c37c27aa11e2ee519a08ede2f (diff) | |
download | hdf5-824ba5e2fde476934df42284271c358b14e1a6af.zip hdf5-824ba5e2fde476934df42284271c358b14e1a6af.tar.gz hdf5-824ba5e2fde476934df42284271c358b14e1a6af.tar.bz2 |
[svn-r9129] Purpose: Updating documentation
Description:
Updated various function headers for the RM as reviewing progresses.
Rearranged functions in header files for more sensible look of the RM.
Platforms tested:
SunOS 5.7 (arabica)
Linux 2.4 (eirene)
Diffstat (limited to 'c++/src/H5DataSpace.h')
-rw-r--r-- | c++/src/H5DataSpace.h | 88 |
1 files changed, 45 insertions, 43 deletions
diff --git a/c++/src/H5DataSpace.h b/c++/src/H5DataSpace.h index 1b231b0..5e20730 100644 --- a/c++/src/H5DataSpace.h +++ b/c++/src/H5DataSpace.h @@ -26,22 +26,37 @@ class H5_DLLCPP DataSpace : public IdComponent { static const DataSpace ALL; // Creates a dataspace object given the space type - DataSpace( H5S_class_t type ); // H5Screate + DataSpace(H5S_class_t type = H5S_SCALAR); // Creates a simple dataspace - DataSpace( int rank, const hsize_t * dims, const hsize_t * maxdims = NULL); // H5Screate_simple - - // Makes copy of an existing dataspace. - void copy( const DataSpace& like_space ); // H5Scopy + DataSpace(int rank, const hsize_t * dims, const hsize_t * maxdims = NULL); // Assignment operator DataSpace& operator=( const DataSpace& rhs ); - // Determines if this dataspace is a simple one. - bool isSimple() const; + // Makes copy of an existing dataspace. + void copy(const DataSpace& like_space); - // Sets the offset of this simple dataspace. - void offsetSimple( const hssize_t* offset ) const; + // Copies the extent of this dataspace. + void extentCopy( DataSpace& dest_space ) const; + + // Gets the bounding box containing the current selection. + void getSelectBounds( hssize_t* start, hssize_t* end ) const; + + // Gets the number of element points in the current selection. + hssize_t getSelectElemNpoints() const; + + // Retrieves the list of element points currently selected. + void getSelectElemPointlist( hsize_t startpoint, hsize_t numpoints, hsize_t *buf ) const; + + // Gets the list of hyperslab blocks currently selected. + void getSelectHyperBlocklist( hsize_t startblock, hsize_t numblocks, hsize_t *buf ) const; + + // Get number of hyperslab blocks. + hssize_t getSelectHyperNblocks() const; + + // Gets the number of elements in this dataspace selection. + hssize_t getSelectNpoints() const; // Retrieves dataspace dimension size and maximum size. int getSimpleExtentDims( hsize_t *dims, hsize_t *maxdims = NULL ) const; @@ -56,39 +71,21 @@ class H5_DLLCPP DataSpace : public IdComponent { // Gets the current class of this dataspace. H5S_class_t getSimpleExtentType() const; - // Copies the extent of this dataspace. - void extentCopy( DataSpace& dest_space ) const; - - // Sets or resets the size of this dataspace. - void setExtentSimple( int rank, const hsize_t *current_size, const hsize_t *maximum_size = NULL ) const; - - // Removes the extent from this dataspace. - void setExtentNone() const; - - // Gets the number of elements in this dataspace selection. - hssize_t getSelectNpoints() const; - - // Get number of hyperslab blocks. - hssize_t getSelectHyperNblocks() const; - - // Gets the list of hyperslab blocks currently selected. - void getSelectHyperBlocklist( hsize_t startblock, hsize_t numblocks, hsize_t *buf ) const; - - // Gets the number of element points in the current selection. - hssize_t getSelectElemNpoints() const; + // Determines if this dataspace is a simple one. + bool isSimple() const; - // Retrieves the list of element points currently selected. - void getSelectElemPointlist( hsize_t startpoint, hsize_t numpoints, hsize_t *buf ) const; + // Sets the offset of this simple dataspace. + void offsetSimple( const hssize_t* offset ) const; - // Gets the bounding box containing the current selection. - void getSelectBounds( hssize_t* start, hssize_t* end ) const; + // Selects the entire dataspace. + void selectAll() const; // Selects array elements to be included in the selection for // this dataspace. void selectElements( H5S_seloper_t op, const size_t num_elements, const hssize_t *coord[ ] ) const; - // Selects the entire dataspace. - void selectAll() const; + // Selects a hyperslab region to add to the current selected region. + void selectHyperslab( H5S_seloper_t op, const hsize_t *count, const hssize_t *start, const hsize_t *stride = NULL, const hsize_t *block = NULL ) const; // Resets the selection region to include no elements. void selectNone() const; @@ -96,19 +93,24 @@ class H5_DLLCPP DataSpace : public IdComponent { // Verifies that the selection is within the extent of the dataspace. bool selectValid() const; - // Selects a hyperslab region to add to the current selected region. - void selectHyperslab( H5S_seloper_t op, const hsize_t *count, const hssize_t *start, const hsize_t *stride = NULL, const hsize_t *block = NULL ) const; + // Removes the extent from this dataspace. + void setExtentNone() const; - // Uses an existing dataspace identifier to make a DataSpace object - // or uses a default id to create a default dataspace object - DataSpace( const hid_t space_id ); + // Sets or resets the size of this dataspace. + void setExtentSimple( int rank, const hsize_t *current_size, const hsize_t *maximum_size = NULL ) const; - // Default constructor - DataSpace(); + // Creates a DataSpace object using an existing dataspace id. + DataSpace(const hid_t space_id); // Copy constructor: makes a copy of the original DataSpace object. - DataSpace( const DataSpace& original ); + DataSpace(const DataSpace& original); + +#ifndef DOXYGEN_SHOULD_SKIP_THIS + // Used by the API to close the dataspace + void p_close() const; +#endif // DOXYGEN_SHOULD_SKIP_THIS + // Destructor: properly terminates access to this dataspace. virtual ~DataSpace(); }; #ifndef H5_NO_NAMESPACE |