Page tree

 

JAVA

FORTRAN

C++

C

 

Link

H5D_OPEN2

Opens an existing dataset

Procedure:

H5D_OPEN2(loc_id, name, dapl_id)

Signature:

hid_t H5Dopen2( hid_t loc_id, const char *name, hid_t dapl_id )

SUBROUTINE h5dopen_f(loc_id, name, dset_id, hdferr, 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(OUT) :: dset_id ! Dataset identifier
  INTEGER, INTENT(OUT) :: hdferr         ! Error code: 
                                         ! 0 on success and -1 on failure
  INTEGER(HID_T), OPTIONAL, INTENT(IN) :: dapl_id 
                                         ! Dataset access property list
END SUBROUTINE h5dopen_f

Parameters:
hid_t loc_idIN: Location identifier; may be a file, group, named datatype, dataset, or attribute
const char *name    IN: Dataset name
hid_t dapl_idIN: Dataset access property list

Description:

H5D_OPEN2 opens the existing dataset specified by a location identifier and name, loc_id and name, respectively. loc_id may be a file, group, dataset, named datatype or attribute.  If an attribute, dataset, or named datatype is specified for loc_id then the dataset will be opened at the location where the attribute, dataset, or named datatype is attached.

The dataset access property list, dapl_id, provides information regarding access to the dataset.

To conserve and release resources, the dataset should be closed when access is no longer required.

Returns:

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

Example:

Coming Soon!

History:
Release    C
1.8.0Function introduced in this release.

--- Last Modified: April 17, 2018 | 02:44 PM