H5Pget_elink_prefix(
hid_t lapl_id,
char *prefix,
size_t size
)
H5Pget_elink_prefix retrieves the prefix applied
to the path of any external links traversed.
When an external link is traversed, the prefix is retrieved
from the link access property list lapl_id,
returned in the user-allocated buffer pointed to by
prefix, and
prepended to the filename stored in the external link.
The size in bytes of the prefix, including the NULL
terminator, is specified in size.
If size is unknown,
a preliminary H5Pget_elink_prefix call
with the pointer prefix set to NULL
will return the size of the prefix
without the NULL terminator.
hid_t lapl_id |
IN: Link access property list identifier |
char *prefix |
OUT: Prefix applied to external link paths |
size_t size |
IN: Size of prefix, including null terminator |
NULL terminator;
otherwise returns a negative value.
| Release | C |
| 1.8.0 | Function introduced in this release. |