Checks if provided key exists in a map object
Procedure:
H5M_EXISTS(map_id, key_mem_type_id, const void *key, hbool_t *exists, dxpl_id)
Signature:
hid_t H5Mexists( hid_t map_id, hid_t key_mem_type_id, const void *key, hbool_t *exists, hid_t dxpl_id )
Parameters:
hid_t map_id | IN: Map object identifier |
hid_t key_mem_type_id | IN: Datatype identifier for a key in memory buffer |
const void *key | IN: Pointer to key buffer |
hbool_t *exists | OUT: Pointer to a buffer to return the existence status |
hid_t dxpl_id | IN: Property list |
Description:
H5M_EXISTS checks if the provided key is stored in the map object specified by map_id. If key_mem_type_id is different from that used to create the map object the key will be internally converted to the datatype for the map object for the query.
Any further options can be specified through the property list dxpl_id.
Returns:
Returns a non-negative value if successful; otherwise returns a negative value.
Example:
History:
| Release | Change |
|---|
| 1.13.0 | C function introduced in this release. |
--- Last Modified: December 20, 2020 | 11:40 PM
