Name: H5Tarray_create1
Signature:
  hid_t `H5Tarray_create1`( hid_t `base_type_id`, int `rank`, const hsize_t `dims[/*rank*/]`, const int `perm[/*rank*/]` )

Purpose:
  Creates an array datatype object.

Notice:
  This function is renamed from `H5Tarray_create` and deprecated in favor of the function `H5Tarray_create2` or the new macro `H5Tarray_create`.

Description:
  `H5Tarray_create1` creates a new array datatype object.

  `base_type_id` is the datatype of every element of the array, i.e., of the number at each position in the array.

  `rank` is the number of dimensions and the size of each dimension is specified in the array `dims`. The value of `rank` is currently limited to `H5S_MAX_RANK` and must be greater than `0` (zero). All dimension sizes specified in `dims` must be greater than `0` (zero).

  The array `perm` is designed to contain the dimension permutation, i.e. C versus FORTRAN array order. (The parameter `perm` is currently unused and is not yet implemented.)

Parameters:

hid_t `base_type_id` | IN: Datatype identifier for the array base datatype.
int `rank` | IN: Rank of the array.
const hsize_t `dims[/*rank*/]` | IN: Size of each array dimension.
const int `perm[/*rank*/]` | IN: Dimension permutation. (Currently not implemented.)

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

Fortran90 Interface: h5tarray_create_f

      SUBROUTINE h5tarray_create_f(base_id, rank, dims, type_id, hdferr)
        IMPLICIT NONE
        INTEGER(HID_T), INTENT(IN) :: base_id   ! Identifier of array base datatype
        INTEGER, INTENT(IN)        ::  rank     ! Rank of the array
        INTEGER(HSIZE_T), DIMENSION(*), INTENT(IN) :: dims
                                                ! Sizes of each array dimension
        INTEGER(HID_T), INTENT(OUT) :: type_id  ! Identifier of the array datatype
        INTEGER, INTENT(OUT)        :: hdferr   ! Error code
      END SUBROUTINE h5tarray_create_f

History:

Release | C
1.4.0 | Function introduced in this release.
1.8.0 | Function `H5Tarray_create` renamed to `H5Tarray_create1` and deprecated in this release.