HDF5 C++ API Reference Manual

 

 

 

Main Page | Namespace List | Class Hierarchy | Class List | File List | Class Members | File Members | Examples

H5::DataSpace Class Reference

#include <H5DataSpace.h>

Inheritance diagram for H5::DataSpace:

H5::IdComponent List of all members.

Public Member Functions

 DataSpace (H5S_class_t type=H5S_SCALAR)
 Creates a new dataspace given a dataspace type.
 DataSpace (int rank, const hsize_t *dims, const hsize_t *maxdims=NULL)
 Creates a new simple dataspace.
DataSpaceoperator= (const DataSpace &rhs)
 Assignment operator.
virtual void close ()
 Closes this dataspace.
void copy (const DataSpace &like_space)
 Makes a copy of an existing dataspace.
void extentCopy (DataSpace &dest_space) const
 Copies the extent of a dataspace.
void getSelectBounds (hsize_t *start, hsize_t *end) const
 Gets the bounding box containing the current selection.
hssize_t getSelectElemNpoints () const
 Returns the number of element points in the current selection.
void getSelectElemPointlist (hsize_t startpoint, hsize_t numpoints, hsize_t *buf) const
 Gets the list of element points currently selected.
void getSelectHyperBlocklist (hsize_t startblock, hsize_t numblocks, hsize_t *buf) const
 Gets the list of hyperslab blocks currently selected.
hssize_t getSelectHyperNblocks () const
 Returns number of hyperslab blocks.
hssize_t getSelectNpoints () const
 Returns the number of elements in a dataspace selection.
int getSimpleExtentDims (hsize_t *dims, hsize_t *maxdims=NULL) const
 Retrieves dataspace dimension size and maximum size.
int getSimpleExtentNdims () const
 Returns the dimensionality of a dataspace.
hssize_t getSimpleExtentNpoints () const
 Returns the number of elements in a dataspace.
H5S_class_t getSimpleExtentType () const
 Returns the current class of a dataspace.
bool isSimple () const
 Determines whether this dataspace is a simple dataspace.
void offsetSimple (const hssize_t *offset) const
 Sets the offset of this simple dataspace.
void selectAll () const
 Selects the entire dataspace.
void selectElements (H5S_seloper_t op, const size_t num_elements, const hsize_t *coord[]) const
 Selects array elements to be included in the selection for this dataspace.
void selectHyperslab (H5S_seloper_t op, const hsize_t *count, const hsize_t *start, const hsize_t *stride=NULL, const hsize_t *block=NULL) const
 Selects a hyperslab region to add to the current selected region.
void selectNone () const
 Resets the selection region to include no elements.
bool selectValid () const
 Verifies that the selection is within the extent of the dataspace.
void setExtentNone () const
 Removes the extent from a dataspace.
void setExtentSimple (int rank, const hsize_t *current_size, const hsize_t *maximum_size=NULL) const
 Sets or resets the size of an existing dataspace.
virtual H5std_string fromClass () const
 DataSpace (const hid_t space_id)
 Creates a DataSpace object using the id of an existing dataspace.
 DataSpace (const DataSpace &original)
 Copy constructor: makes a copy of the original DataSpace object.
virtual ~DataSpace ()
 Properly terminates access to this dataspace.

Static Public Attributes

const DataSpace ALL
 Constant for default dataspace.

Constructor & Destructor Documentation

H5::DataSpace::DataSpace H5S_class_t  type = H5S_SCALAR  ) 
 

Creates a new dataspace given a dataspace type.

Parameters:
type - IN: Type of the dataspace to be created, which currently can be either H5S_SCALAR or H5S_SIMPLE; default to H5S_SCALAR.
Exceptions:
H5::DataSpaceIException 

H5::DataSpace::DataSpace int  rank,
const hsize_t *  dims,
const hsize_t *  maxdims = NULL
 

Creates a new simple dataspace.

Parameters:
rank - IN: Number of dimensions of dataspace.
dims - IN: An array of the size of each dimension.
maxdims - IN: An array of the maximum size of each dimension.
Exceptions:
H5::DataSpaceIException 

H5::DataSpace::DataSpace const hid_t  existing_id  ) 
 

Creates a DataSpace object using the id of an existing dataspace.

Parameters:
existing_id - IN: Id of an existing dataspace
Exceptions:
H5::DataSpaceIException 

H5::DataSpace::DataSpace const DataSpace original  ) 
 

Copy constructor: makes a copy of the original DataSpace object.

Parameters:
original - IN: DataSpace object to copy

H5::DataSpace::~DataSpace  )  [virtual]
 

Properly terminates access to this dataspace.


Member Function Documentation

DataSpace & H5::DataSpace::operator= const DataSpace rhs  ) 
 

Assignment operator.

Parameters:
rhs - IN: Reference to the existing dataspace
Returns:
Reference to DataSpace instance
Exceptions:
H5::DataSpaceIException 

void H5::DataSpace::close  )  [virtual]
 

Closes this dataspace.

Exceptions:
H5::DataSpaceIException 

void H5::DataSpace::copy const DataSpace like_space  ) 
 

Makes a copy of an existing dataspace.

Parameters:
like_space - IN: Dataspace to be copied
Exceptions:
H5::DataSpaceIException 

void H5::DataSpace::extentCopy DataSpace dest_space  )  const
 

Copies the extent of a dataspace.

Parameters:
dest_space - IN: Dataspace to copy from
Exceptions:
H5::DataSpaceIException 

void H5::DataSpace::getSelectBounds hsize_t *  start,
hsize_t *  end
const
 

Gets the bounding box containing the current selection.

Parameters:
start - IN: Starting coordinates of the bounding box
end - IN: Ending coordinates of the bounding box, i.e., the coordinates of the diagonally opposite corner
Exceptions:
H5::DataSpaceIException 
Description
For more information, please refer to the C layer Reference Manual at: ../RM_H5S.html#Dataspace-SelectBounds

hssize_t H5::DataSpace::getSelectElemNpoints  )  const
 

Returns the number of element points in the current selection.

Returns:
Number of element points
Exceptions:
H5::DataSpaceIException 

void H5::DataSpace::getSelectElemPointlist hsize_t  startpoint,
hsize_t  numpoints,
hsize_t *  buf
const
 

Gets the list of element points currently selected.

Parameters:
startpoint - IN: Element point to start with
numpoints - IN: Number of element points to get
buf - IN: List of element points selected
Exceptions:
H5::DataSpaceIException 
Description
For more information, please refer to the C layer Reference Manual at: ../RM_H5S.html#Dataspace-SelectElemPointList

void H5::DataSpace::getSelectHyperBlocklist hsize_t  startblock,
hsize_t  numblocks,
hsize_t *  buf
const
 

Gets the list of hyperslab blocks currently selected.

Parameters:
startblock - IN: Hyperslab block to start with
numblocks - IN: Number of hyperslab blocks to get
buf - IN: List of hyperslab blocks selected
Exceptions:
H5::DataSpaceIException 

hssize_t H5::DataSpace::getSelectHyperNblocks  )  const
 

Returns number of hyperslab blocks.

Returns:
Number of hyperslab blocks
Exceptions:
H5::DataSpaceIException 

hssize_t H5::DataSpace::getSelectNpoints  )  const
 

Returns the number of elements in a dataspace selection.

Returns:
Number of elements
Exceptions:
H5::DataSpaceIException 

int H5::DataSpace::getSimpleExtentDims hsize_t *  dims,
hsize_t *  maxdims = NULL
const
 

Retrieves dataspace dimension size and maximum size.

Parameters:
dims - IN: Name of the new member
maxdims - IN: Pointer to the value of the new member
Returns:
Number of dimensions, the same value as returned by DataSpace::getSimpleExtentNdims()
Exceptions:
H5::DataSpaceIException 

int H5::DataSpace::getSimpleExtentNdims  )  const
 

Returns the dimensionality of a dataspace.

Returns:
Number of dimensions
Exceptions:
H5::DataSpaceIException 

hssize_t H5::DataSpace::getSimpleExtentNpoints  )  const
 

Returns the number of elements in a dataspace.

Returns:
Number of elements
Exceptions:
H5::DataSpaceIException 

H5S_class_t H5::DataSpace::getSimpleExtentType  )  const
 

Returns the current class of a dataspace.

Returns:
Class of the dataspace
Exceptions:
H5::DataSpaceIException 

bool H5::DataSpace::isSimple  )  const
 

Determines whether this dataspace is a simple dataspace.

Returns:
true if the dataspace is a simple dataspace, and false, otherwise
Exceptions:
H5::DataSpaceIException 

void H5::DataSpace::offsetSimple const hssize_t *  offset  )  const
 

Sets the offset of this simple dataspace.

Parameters:
offset - IN: Offset to position the selection at
Exceptions:
H5::DataSpaceIException 
Description
This function creates an offset for the selection within an extent, allowing the same shaped selection to be moved to different locations within a dataspace without requiring it to be re-defined.

void H5::DataSpace::selectAll  )  const
 

Selects the entire dataspace.

Exceptions:
H5::DataSpaceIException 

void H5::DataSpace::selectElements H5S_seloper_t  op,
const size_t  num_elements,
const hsize_t *  coord[]
const
 

Selects array elements to be included in the selection for this dataspace.

Parameters:
op - IN: Operator specifying how the new selection is to be combined with the existing selection for the dataspace
num_elements - IN: Number of elements to be selected
coord - IN: A 2-dimensional array of 0-based values specifying the coordinates of the elements being selected
Exceptions:
H5::DataSpaceIException 
Description
For more information, please refer to the C layer Reference Manual at: ../RM_H5S.html#Dataspace-SelectElements

void H5::DataSpace::selectHyperslab H5S_seloper_t  op,
const hsize_t *  count,
const hsize_t *  start,
const hsize_t *  stride = NULL,
const hsize_t *  block = NULL
const
 

Selects a hyperslab region to add to the current selected region.

Parameters:
op - IN: Operation to perform on current selection
count - IN: Number of blocks included in the hyperslab
start - IN: Offset of the start of hyperslab
stride - IN: Hyperslab stride - default to NULL
block - IN: Size of block in the hyperslab - default to NULL
Exceptions:
H5::DataSpaceIException 
Description
For more information, please refer to the C layer Reference Manual at: ../RM_H5S.html#Dataspace-SelectHyperslab

void H5::DataSpace::selectNone  )  const
 

Resets the selection region to include no elements.

Exceptions:
H5::DataSpaceIException 

bool H5::DataSpace::selectValid  )  const
 

Verifies that the selection is within the extent of the dataspace.

Returns:
true if the selection is within the extent of the dataspace, and false, otherwise
Exceptions:
H5::DataSpaceIException 

void H5::DataSpace::setExtentNone  )  const
 

Removes the extent from a dataspace.

Exceptions:
H5::DataSpaceIException 

void H5::DataSpace::setExtentSimple int  rank,
const hsize_t *  current_size,
const hsize_t *  maximum_size = NULL
const
 

Sets or resets the size of an existing dataspace.

Parameters:
rank - IN: Rank of the dataspace
current_size - IN: Array containing current size of dataspace
maximum_size - IN: Array containing maximum size of dataspace
Exceptions:
H5::DataSpaceIException 

virtual H5std_string H5::DataSpace::fromClass  )  const [inline, virtual]
 


Member Data Documentation

const DataSpace H5::DataSpace::ALL [static]
 

Constant for default dataspace.


Generated on Tue Aug 14 13:56:59 2007 by  doxygen 1.3.9.1