H5S_CREATE_SIMPLE creates a new simple dataspace and opens it for access, returning a dataspace identifier. rank is the number of dimensions used in the dataspace.
current_dims is a one-dimensional array of size rank specifying the size of each dimension of the dataset. maximum_dims is an array of the same size specifying the upper limit on the size of each dimension.
Any element of current_dims can be 0 (zero). Note that no data can be written to a dataset if the size of any dimension of its current dataspace is 0 . This is sometimes a useful initial state for a dataset. maximum_dims may be the null pointer, in which case the upper limit is the same as current_dims . Otherwise, no element of maximum_dims should be smaller than the corresponding element of current_dims .
If an element of maximum_dims is H5S_UNLIMITED , the maximum size of the corresponding dimension is unlimited. Any dataset with an unlimited dimension must also be chunked; see H5P_SET_CHUNK. Similarly, a dataset must be chunked if current_dims does not equal maximum_dims . The dataspace identifier returned from this function must be released with H5S_CLOSE or resource leaks will occur. |