Last modified: 9 April 2009
Name: H5Tarray_create2
Signature:
  hid_t `H5Tarray_create2`( hid_t `base_type_id`, unsigned `rank`, const hsize_t `dims[/*rank*/]` )

Purpose:
  Creates an array datatype object.

Description:
  `H5Tarray_create2` 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).

Parameters:

hid_t `base_type_id` | IN: Datatype identifier for the array base datatype.
unsigned `rank` | IN: Rank of the array.
const hsize_t `dims[/*rank*/]` | IN: Size of each array dimension.

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

Fortran90 Interface:
  None.

History:

Release | Change
1.8.0 | C function introduced in this release.