H5Olink(
hid_t object_id,
hid_t new_loc_id,
const char *new_link_name,
hid_t lcpl,
hid_t lapl
)
H5Olink creates a new hard link to an object in
an HDF5 file.
new_loc_id and new_name specify the
location and name of the new link while object_id
identifies the object that the link points to.
H5Olink is designed for two purposes:
H5Dcreate_anon,
H5Gcreate_anon,
or
H5Tcommit_anon.
| |
|
|
lcpl and lapl are the
link creation and access property lists associated with the
new link.
hid_t object_id |
IN: Object to be linked. |
hid_t new_loc_id |
IN: File or group identifier specifying location at which object is to be linked. |
const char *new_link_name |
IN: Name of link to be created, relative to
new_loc_id. |
hid_t lcpl_id |
IN: Link creation property list identifier. |
hid_t lapl_id |
IN: Link access property list identifier. |
C
with the path /A/B01/C but may not know at run time
whether the groups A and B01 exist.
The following code ensures that those groups are created
if they are missing:
hid_t lcpl_id = H5Pcreate(H5P_LINK_CREATE);
/* Creates a link creation property
* list (LCPL). */
int status = H5Pset_create_intermediate_group(lcpl_id, TRUE);
/* Sets "create missing intermediate
* groups" property in that LCPL. */
hid_t gid = H5Gcreate_anon(file_id, H5P_DEFAULT, H5P_DEFAULT);
/* Creates a group without linking
* it into the file structure. */
status = H5Olink(obj_id, file_id, "/A/B01/C", lcpl_id, H5P_DEFAULT);
/* Links group into file structure.*/
Note that unless the object is intended to be temporary,
the H5Olink call is mandatory if an object created
with one of the H5*create_anon functions
(or with H5Tcommit_anon)
is to be retained in the file;
without an H5Olink call, the object will not be linked into
the HDF5 file structure and will be deleted when the file is closed.
H5Dcreate_anon
H5Gcreate_anon
H5Tcommit_anon
| Release | C |
| 1.8.1 | Fortran subroutine introduced in this release. |
| 1.8.0 | Function introduced in this release. |