Creates a new dataspace of a specified type

Procedure:

H5S_CREATE ( type )

Signature:

<pre><code class="language-c">hid_t H5Screate(
        H5S_class_t type
        )

</code></pre>

<pre><code class="language-fortran">Fortran90 Interface: h5screate_f
    
SUBROUTINE h5screate_f(classtype, space_id, hdferr) 
  IMPLICIT NONE
  INTEGER, INTENT(IN) :: classtype        ! The type of the dataspace
                                          ! to be created. Possible values
                                          ! are: 
                                          !    H5S_SCALAR_F 
                                          !    H5S_SIMPLE_F 
                                          !    H5S_NULL_F
  INTEGER(HID_T), INTENT(OUT) :: space_id ! Dataspace identifier 
  INTEGER, INTENT(OUT) :: hdferr          ! Error code
                                          ! 0 on success and -1 on failure
END SUBROUTINE h5screate_f
    


  </code></pre>

Parameters:
H5S_class_t type     IN: Type of dataspace to be created

Description:

H5S_CREATE creates a new dataspace of a particular type. Currently supported types are as follows:
     H5S_SCALAR
     H5S_SIMPLE
     H5S_NULL
Further dataspace types may be added later.

A scalar dataspace, H5S_SCALAR, has a single element, though that element may be of a complex datatype, such as a compound or array datatype. By convention, the rank of a scalar dataspace is always 0 (zero); think of it geometrically as a single, dimensionless point, though that point can be complex.

A simple dataspace, H5S_SIMPLE, consists of a regular array of elements.

A null dataspace, H5S_NULL, has no data elements.

The dataspace identifier returned by this function can be released with H5S_CLOSE so that resource leaks will not occur.

Returns:

Returns a dataspace identifier if successful; otherwise returns a negative value.

Example:

History:

None