Last modified: 28 August 2012
Name: H5Dopen1

Signature:
  hid_t `H5Dopen1`( hid_t `loc_id`, const char *`name` )

Purpose:
  Opens an existing dataset.

Notice:
  This function is deprecated in favor of the function `H5Dopen2` or the macro `H5Dopen`.

Description:
  `H5Dopen1` opens an existing dataset for access in the file or group specified in `loc_id`. `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 `H5Dclose` when the dataset is no longer needed so that resource leaks will not develop.

Parameters:

hid_t `loc_id` | IN: Identifier of the file or group within which the dataset to be accessed will be found.
const char * `name` | IN: The name of the dataset to access.

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

Fortran90 Interface: See listing under `H5Dopen`.

History:

  Release | C
  1.8.0 | Function `H5Dopen` renamed to `H5Dopen1` and deprecated in this release.