Page tree

The license could not be verified: License Certificate has expired!

 

JAVA

FORTRAN

C++

C

 

Link

H5D_CREATE

Creates a new dataset and links it to a location in the file

Signature:

hid_t H5Dcreatehid_t loc_id,const char *namehid_t type_idhid_t space_idhid_t dcpl_id )

hid_t H5Dcreatehid_t loc_idconst char *namehid_t dtype_idhid_t space_idhid_t lcpl_idhid_t dcpl_idhid_t dapl_id ) 

SUBROUTINE h5dcreate_f(loc_id, name, type_id, space_id, dset_id, & 
     hdferr, dcpl_id, lcpl_id, dapl_id)

  IMPLICIT NONE
  INTEGER(HID_T), INTENT(IN) :: loc_id   ! File or group identifier 
  CHARACTER(LEN=*), INTENT(IN) :: name   ! Name of the dataset 
  INTEGER(HID_T), INTENT(IN) :: type_id  ! Datatype identifier 
  INTEGER(HID_T), INTENT(IN) :: space_id ! Dataspace identifier 
  INTEGER(HID_T), INTENT(OUT) :: dset_id ! Dataset identifier 
  INTEGER, INTENT(OUT) :: hdferr         ! Error code  
                                         ! 0 on success and -1 on failure
  INTEGER(HID_T), OPTIONAL, INTENT(IN) :: dcpl_id 
                                         ! Dataset creation property list
  INTEGER(HID_T), OPTIONAL, INTENT(IN) :: lcpl_id 
                                         ! Link creation property list
  INTEGER(HID_T), OPTIONAL, INTENT(IN) :: dapl_id 
                                         ! Dataset access property list
END SUBROUTINE h5dcreate_f

Description:

H5D_CREATE is a macro that is mapped to either H5D_CREATE1 or H5D_CREATE2, depending on the needs of the application.

Such macros are provided to facilitate application compatibility. Their use and mappings are fully described in API Compatibility Macros in HDF5; we urge you to read that document closely.

When both the HDF5 library and the application are built and installed with no specific compatibility flags, H5D_CREATE is mapped to the most recent version of the function, currently H5D_CREATE2. If the library and/or application is compiled for Release 1.6 emulation, H5D_CREATE will be mapped to H5D_CREATE1. Function-specific flags are available to override these settings on a function-by-function basis when the application is compiled.

Specific compile-time compatibility flags and the resulting mappings are as follows:

Compatibility settingH5D_CREATE mapping

Global settings
No compatibility flagH5D_CREATE2
Enable deprecated symbolsH5D_CREATE2
Disable deprecated symbolsH5D_CREATE2
Emulate Release 1.6 interface    H5D_CREATE1

Function-level macros
H5Dcreate_vers = 2H5D_CREATE2
H5Dcreate_vers = 1H5D_CREATE1

A dataset created with this macro should be closed with H5D_CLOSE when the dataset is no longer needed so that resource leaks will not develop.

Example:

See either H5D_CREATE1 or H5D_CREATE2.

  !
  ! Create the dataset with default properties.
  !
  CALL h5dcreate_f(file_id, dsetname, H5T_NATIVE_INTEGER, dspace_id, &
       dset_id, error)

History:
Release    C
1.8.0The function H5Dcreate renamed to H5Dcreate1 and deprecated in this release. 
The macro H5Dcreate and the function H5Dcreate2 introduced in this release.

--- Last Modified: April 10, 2018 | 03:34 PM