Last modified: 14 October 2014
Name: H5Screate

Signature:
  hid_t `H5Screate`( H5S_class_t `type` )

Purpose:
  Creates a new dataspace of a specified type.

Description:
  `H5Screate` 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 `H5Sclose` so that resource leaks will not occur.

Parameters:

  H5S_class_t `type` | IN: Type of dataspace to be created.

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

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

See Also:
  “Using Identifiers”