H5Lcreate_ud(
hid_t link_loc_id,
const char *link_name,
H5L_type_t link_type,
const char *udata,
size_t udata_size,
hid_t lcpl_id,
hid_t lapl_id
)
H5Lcreate_ud creates a link
of user-defined type link_type
named link_name
at the location specified in link_loc_id
with user-specified data udata.
link_name is interpreted relative to
link_loc_id.
Valid values for the link class of the new link,
link_type, include H5L_TYPE_EXTERNAL
and any user-defined link classes that have been registered
with the library.
See H5Lregister
for further information.
The format of the information pointed to by udata is
defined by the user.
udata_size specifies the size of the udata
buffer.
udata may be NULL if
udata_size is zero (0).
The property lists specified by lcpl_id and
lapl_id specify properties used to create and access
the link.
H5L_TYPE_EXTERNAL,
included in the HDF5 Library distribution, is implemented as a
user-defined link type.
This was done, in part, to provide a model for the implementation
of other user-defined links.
hid_t link_loc_id
|
IN: Link location identifier |
const char *link_name
|
IN: Link name |
H5L_type_t link_type
|
IN: User-defined link class |
const char *udata
|
IN: User-supplied link information |
size_t udata_size
|
IN: Size of udata buffer
|
hid_t lcpl_id
|
IN: Link creation property list identifier |
hid_t lapl_id
|
IN: Link access property list identifier |
| Release | C |
| 1.8.0 | Function introduced in this release. |