Page tree

 

JAVA

FORTRAN

C++

C

 

Link

H5D_OPEN1

Opens an existing dataset

Procedure:

H5D_OPEN1(loc_id, name)

Signature:

hid_t H5Dopen1( hid_t loc_id, const char *name )

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_id

IN: Location identifier; may be a file, group, dataset, named datatype, or attribute

const char * name

IN: The name of the dataset to access

Description:

H5D_OPEN1 opens an existing dataset for access at the location specified by loc_idloc_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. name is a dataset name and is used to identify the dataset in the file.

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

Returns:

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

Example:

Coming Soon!

History:
ReleaseC
1.8.0Function H5Dopen renamed to H5Dopen1 and deprecated in this release.

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