|
My Project 1.10.10
|
H5Location is an abstract base class, added in version 1.8.12. More...
#include <H5Location.h>
Public Member Functions | |
| bool | nameExists (const char *name, const LinkAccPropList &lapl=LinkAccPropList::DEFAULT) const |
| Checks if a link of a given name exists in a location. | |
| bool | nameExists (const H5std_string &name, const LinkAccPropList &lapl=LinkAccPropList::DEFAULT) const |
| Checks if a link of a given name exists in a location. | |
| bool | exists (const char *name, const LinkAccPropList &lapl=LinkAccPropList::DEFAULT) const |
| Deprecated in favor of nameExists. | |
| bool | exists (const H5std_string &name, const LinkAccPropList &lapl=LinkAccPropList::DEFAULT) const |
| Deprecated in favor of nameExists. | |
| void | flush (H5F_scope_t scope) const |
| Flushes all buffers associated with a location to disk. | |
| H5std_string | getFileName () const |
| Gets the name of the file, in which an HDF5 object at this location belongs. | |
| H5G_obj_t | getObjType (void *ref, H5R_type_t ref_type=H5R_OBJECT) const |
| Retrieves the type of object that an object reference points to. | |
| H5O_type_t | getRefObjType (void *ref, H5R_type_t ref_type=H5R_OBJECT) const |
| Retrieves the type of object that an object reference points to. | |
| void | setComment (const char *name, const char *comment) const |
| Sets or resets the comment for an object specified by its name. | |
| void | setComment (const H5std_string &name, const H5std_string &comment) const |
This is an overloaded member function, provided for convenience. It differs from the above function in that it takes an H5std_string for name and comment. | |
| void | setComment (const char *comment) const |
| This is an overloaded member function, provided for convenience. It differs from the above function in that it doesn't take an object name. | |
| void | setComment (const H5std_string &comment) const |
This is an overloaded member function, provided for convenience. It differs from the above function in that it takes an H5std_string for comment. | |
| ssize_t | getComment (const char *name, size_t buf_size, char *comment) const |
| Retrieves the comment for this location, returning its length. | |
| H5std_string | getComment (const char *name, size_t buf_size=0) const |
| Returns the comment as string for this location, returning its length. | |
| H5std_string | getComment (const H5std_string &name, size_t buf_size=0) const |
This is an overloaded member function, provided for convenience. It differs from the above function in that it takes an H5std_string for name. | |
| void | removeComment (const char *name) const |
| Removes the comment from an object specified by its name. | |
| void | removeComment (const H5std_string &name) const |
This is an overloaded member function, provided for convenience. It differs from the above function in that it takes an H5std_string for name. | |
| void | reference (void *ref, const char *name, H5R_type_t ref_type=H5R_OBJECT) const |
| This is an overloaded function, provided for your convenience. It differs from the above function in that it does not take a DataSpace object and the reference type must be specified. | |
| void | reference (void *ref, const H5std_string &name, H5R_type_t ref_type=H5R_OBJECT) const |
This is an overloaded function, provided for your convenience. It differs from the above function in that it takes an H5std_string for the object's name. | |
| void | reference (void *ref, const char *name, const DataSpace &dataspace, H5R_type_t ref_type=H5R_DATASET_REGION) const |
| Creates a reference to an HDF5 object or a dataset region. | |
| void | reference (void *ref, const H5std_string &name, const DataSpace &dataspace, H5R_type_t ref_type=H5R_DATASET_REGION) const |
This is an overloaded member function, provided for convenience. It differs from the above function in that it takes an H5std_string for name. | |
| void | dereference (const H5Location &loc, const void *ref, H5R_type_t ref_type=H5R_OBJECT, const PropList &plist=PropList::DEFAULT) |
| Dereferences a reference into an HDF5 object, given an HDF5 object. | |
| DataSpace | getRegion (void *ref, H5R_type_t ref_type=H5R_DATASET_REGION) const |
| Retrieves a dataspace with the region pointed to selected. | |
| Group | createGroup (const char *name, const LinkCreatPropList &lcpl) const |
| Creates a new group at this location, which can be a file, group, dataset, attribute, or named datatype. | |
| Group | createGroup (const H5std_string &name, const LinkCreatPropList &lcpl) const |
This is an overloaded member function, provided for convenience. It differs from the above function in that it takes an H5std_string for name. | |
| Group | createGroup (const char *name, size_t size_hint=0) const |
| Creates a new group at this location, which can be a file, group, dataset, attribute, or named datatype. | |
| Group | createGroup (const H5std_string &name, size_t size_hint=0) const |
This is an overloaded member function, provided for convenience. It differs from the above function in that it takes an H5std_string for name. | |
| Group | openGroup (const char *name) const |
| Opens an existing group in a location which can be a file or another group. | |
| Group | openGroup (const H5std_string &name) const |
This is an overloaded member function, provided for convenience. It differs from the above function in that it takes an H5std_string for name. | |
| DataSet | createDataSet (const char *name, const DataType &data_type, const DataSpace &data_space, const DSetCreatPropList &create_plist=DSetCreatPropList::DEFAULT, const DSetAccPropList &dapl=DSetAccPropList::DEFAULT, const LinkCreatPropList &lcpl=LinkCreatPropList::DEFAULT) const |
| Creates a new dataset at this location. | |
| DataSet | createDataSet (const H5std_string &name, const DataType &data_type, const DataSpace &data_space, const DSetCreatPropList &create_plist=DSetCreatPropList::DEFAULT, const DSetAccPropList &dapl=DSetAccPropList::DEFAULT, const LinkCreatPropList &lcpl=LinkCreatPropList::DEFAULT) const |
This is an overloaded member function, provided for convenience. It differs from the above function in that it takes an H5std_string for name. | |
| DataSet | openDataSet (const char *name, const DSetAccPropList &dapl=DSetAccPropList::DEFAULT) const |
| Opens an existing dataset at this location. | |
| DataSet | openDataSet (const H5std_string &name, const DSetAccPropList &dapl=DSetAccPropList::DEFAULT) const |
This is an overloaded member function, provided for convenience. It differs from the above function in that it takes an H5std_string for name. | |
| H5L_info_t | getLinkInfo (const char *link_name, const LinkAccPropList &lapl=LinkAccPropList::DEFAULT) const |
| Returns the information of the named link. | |
| H5L_info_t | getLinkInfo (const H5std_string &link_name, const LinkAccPropList &lapl=LinkAccPropList::DEFAULT) const |
This is an overloaded member function, provided for convenience. It differs from the above function in that it takes an H5std_string for link_name. | |
| H5std_string | getLinkval (const char *link_name, size_t size=0) const |
| Returns the name of the object that the symbolic link points to. | |
| H5std_string | getLinkval (const H5std_string &link_name, size_t size=0) const |
This is an overloaded member function, provided for convenience. It differs from the above function in that it takes an H5std_string for name. | |
| hsize_t | getNumObjs () const |
| Deprecated - moved to H5::Group in 1.10.2. | |
| H5std_string | getObjnameByIdx (hsize_t idx) const |
| Returns the name of an object in this group, given the object's index. | |
| ssize_t | getObjnameByIdx (hsize_t idx, char *name, size_t size) const |
| Retrieves the name of an object in this group, given the object's index. | |
| ssize_t | getObjnameByIdx (hsize_t idx, H5std_string &name, size_t size) const |
This is an overloaded member function, provided for convenience. It differs from the above function in that it takes an H5std_string for name. | |
| H5O_type_t | childObjType (const H5std_string &objname) const |
| This is an overloaded member function, provided for convenience. It takes an H5std_string for the object's name. | |
| H5O_type_t | childObjType (const char *objname) const |
| Returns the type of an object in this file/group, given the object's name. | |
| H5O_type_t | childObjType (hsize_t index, H5_index_t index_type=H5_INDEX_NAME, H5_iter_order_t order=H5_ITER_INC, const char *objname=".") const |
| Returns the type of an object in this file/group, given the object's index and its type and order. | |
| unsigned | childObjVersion (const char *objname) const |
| Returns the object header version of an object in this file/group, given the object's name. | |
| unsigned | childObjVersion (const H5std_string &objname) const |
| This is an overloaded member function, provided for convenience. It takes an H5std_string for the object's name. | |
| void | getObjinfo (H5O_info_t &objinfo, unsigned fields=H5O_INFO_BASIC) const |
| Retrieves information about an HDF5 object. | |
| void | getObjinfo (const char *name, H5O_info_t &objinfo, unsigned fields=H5O_INFO_BASIC, const LinkAccPropList &lapl=LinkAccPropList::DEFAULT) const |
| Retrieves information about an HDF5 object given its name. | |
| void | getObjinfo (const H5std_string &name, H5O_info_t &objinfo, unsigned fields=H5O_INFO_BASIC, const LinkAccPropList &lapl=LinkAccPropList::DEFAULT) const |
This is an overloaded member function, provided for convenience. It differs from the above function in that it takes a reference to an H5std_string for name. | |
| void | getObjinfo (const char *grp_name, H5_index_t idx_type, H5_iter_order_t order, hsize_t idx, H5O_info_t &objinfo, unsigned fields=H5O_INFO_BASIC, const LinkAccPropList &lapl=LinkAccPropList::DEFAULT) const |
| Retrieves information about an HDF5 object given its index. | |
| void | getObjinfo (const H5std_string &grp_name, H5_index_t idx_type, H5_iter_order_t order, hsize_t idx, H5O_info_t &objinfo, unsigned fields=H5O_INFO_BASIC, const LinkAccPropList &lapl=LinkAccPropList::DEFAULT) const |
This is an overloaded member function, provided for convenience. It differs from the above function in that it takes a reference to an H5std_string for name. | |
| H5G_obj_t | getObjTypeByIdx (hsize_t idx) const |
| Returns the type of an object in this group, given the object's index. | |
| H5G_obj_t | getObjTypeByIdx (hsize_t idx, char *type_name) const |
| This is an overloaded member function, provided for convenience. It differs from the above function because it also provides the returned object type in text (char*) | |
| H5G_obj_t | getObjTypeByIdx (hsize_t idx, H5std_string &type_name) const |
| This is an overloaded member function, provided for convenience. It differs from the above function because it also provides the returned object type in text (H5std_string&) | |
| void | getObjinfo (const char *name, hbool_t follow_link, H5G_stat_t &statbuf) const |
| Returns information about an object. | |
| void | getObjinfo (const H5std_string &name, hbool_t follow_link, H5G_stat_t &statbuf) const |
This is an overloaded member function, provided for convenience. It differs from the above function in that it takes an H5std_string for name. | |
| void | getObjinfo (const char *name, H5G_stat_t &statbuf) const |
| This is an overloaded member function, provided for convenience. It differs from the above functions in that it doesn't have the parameter follow_link. | |
| void | getObjinfo (const H5std_string &name, H5G_stat_t &statbuf) const |
This is an overloaded member function, provided for convenience. It differs from the above function in that it takes an H5std_string for name. | |
| int | iterateElems (const char *name, int *idx, H5G_iterate_t op, void *op_data) |
| Iterates a user's function over the entries of a group. | |
| int | iterateElems (const H5std_string &name, int *idx, H5G_iterate_t op, void *op_data) |
This is an overloaded member function, provided for convenience. It differs from the above function in that it takes an H5std_string for name. | |
| void | link (const char *target_name, const char *link_name, const LinkCreatPropList &lcpl=LinkCreatPropList::DEFAULT, const LinkAccPropList &lapl=LinkAccPropList::DEFAULT) const |
| Creates a soft link from link_name to target_name. | |
| void | link (const H5std_string &target_name, const H5std_string &link_name, const LinkCreatPropList &lcpl=LinkCreatPropList::DEFAULT, const LinkAccPropList &lapl=LinkAccPropList::DEFAULT) const |
This is an overloaded member function, provided for convenience. It differs from the above function in that it takes an H5std_string for target_name and link_name. | |
| void | link (const char *curr_name, const Group &new_loc, const char *new_name, const LinkCreatPropList &lcpl=LinkCreatPropList::DEFAULT, const LinkAccPropList &lapl=LinkAccPropList::DEFAULT) const |
| Creates a hard link from new_name to curr_name. | |
| void | link (const H5std_string &curr_name, const Group &new_loc, const H5std_string &new_name, const LinkCreatPropList &lcpl=LinkCreatPropList::DEFAULT, const LinkAccPropList &lapl=LinkAccPropList::DEFAULT) const |
This is an overloaded member function, provided for convenience. It differs from the above function in that it takes an H5std_string for curr_name and new_name. | |
| void | link (const char *curr_name, const hid_t same_loc, const char *new_name, const LinkCreatPropList &lcpl=LinkCreatPropList::DEFAULT, const LinkAccPropList &lapl=LinkAccPropList::DEFAULT) const |
| Creates a hard link from new_name to curr_name - can be used to pass in H5L_SAME_LOC. | |
| void | link (const H5std_string &curr_name, const hid_t same_loc, const H5std_string &new_name, const LinkCreatPropList &lcpl=LinkCreatPropList::DEFAULT, const LinkAccPropList &lapl=LinkAccPropList::DEFAULT) const |
This is an overloaded member function, provided for convenience. It differs from the above function in that it takes an H5std_string for curr_name and new_name. | |
| void | link (H5L_type_t link_type, const char *curr_name, const char *new_name) const |
| Creates a link of the specified type from new_name to curr_name. | |
| void | link (H5L_type_t link_type, const H5std_string &curr_name, const H5std_string &new_name) const |
This is an overloaded member function, provided for convenience. It differs from the above function in that it takes an H5std_string for curr_name and new_name. | |
| void | unlink (const char *link_name, const LinkAccPropList &lapl=LinkAccPropList::DEFAULT) const |
| Removes the specified link from this group. | |
| void | unlink (const H5std_string &link_name, const LinkAccPropList &lapl=LinkAccPropList::DEFAULT) const |
This is an overloaded member function, provided for convenience. It differs from the above function in that it takes an H5std_string for name. | |
| void | mount (const char *name, const H5File &child, const PropList &plist) const |
| Mounts the file child onto this group. | |
| void | mount (const H5std_string &name, const H5File &child, const PropList &plist) const |
This is an overloaded member function, provided for convenience. It takes an H5std_string for name. | |
| void | unmount (const char *name) const |
| Unmounts the specified file. | |
| void | unmount (const H5std_string &name) const |
This is an overloaded member function, provided for convenience. It differs from the above function in that it takes an H5std_string for name. | |
| void | copyLink (const char *src_name, const Group &dst, const char *dst_name, const LinkCreatPropList &lcpl=LinkCreatPropList::DEFAULT, const LinkAccPropList &lapl=LinkAccPropList::DEFAULT) const |
| Copies a link from one group to another. | |
| void | copyLink (const H5std_string &src_name, const Group &dst, const H5std_string &dst_name, const LinkCreatPropList &lcpl=LinkCreatPropList::DEFAULT, const LinkAccPropList &lapl=LinkAccPropList::DEFAULT) const |
This is an overloaded member function, provided for convenience. It differs from the above function in that it takes an H5std_string for src_name and dst_name. | |
| void | copyLink (const char *src_name, const char *dst_name, const LinkCreatPropList &lcpl=LinkCreatPropList::DEFAULT, const LinkAccPropList &lapl=LinkAccPropList::DEFAULT) const |
| Copies a link from a group in the same location. | |
| void | copyLink (const H5std_string &src_name, const H5std_string &dst_name, const LinkCreatPropList &lcpl=LinkCreatPropList::DEFAULT, const LinkAccPropList &lapl=LinkAccPropList::DEFAULT) const |
This is an overloaded member function, provided for convenience. It differs from the above function in that it takes an H5std_string for src_name and dst_name. | |
| void | moveLink (const char *src_name, const Group &dst, const char *dst_name, const LinkCreatPropList &lcpl=LinkCreatPropList::DEFAULT, const LinkAccPropList &lapl=LinkAccPropList::DEFAULT) const |
| Renames a link in this group and moves it to a new location. | |
| void | moveLink (const H5std_string &src_name, const Group &dst, const H5std_string &dst_name, const LinkCreatPropList &lcpl=LinkCreatPropList::DEFAULT, const LinkAccPropList &lapl=LinkAccPropList::DEFAULT) const |
This is an overloaded member function, provided for convenience. It differs from the above function in that it takes an H5std_string for src_name and dst_name. | |
| void | moveLink (const char *src_name, const char *dst_name, const LinkCreatPropList &lcpl=LinkCreatPropList::DEFAULT, const LinkAccPropList &lapl=LinkAccPropList::DEFAULT) const |
| Renames a link in this group. | |
| void | moveLink (const H5std_string &src_name, const H5std_string &dst_name, const LinkCreatPropList &lcpl=LinkCreatPropList::DEFAULT, const LinkAccPropList &lapl=LinkAccPropList::DEFAULT) const |
This is an overloaded member function, provided for convenience. It differs from the above function in that it takes an H5std_string for src_name and dst_name. | |
| void | move (const char *src, const char *dst) const |
| Renames an object at this location. - Deprecated due to inadequate functionality. | |
| void | move (const H5std_string &src, const H5std_string &dst) const |
This is an overloaded member function, provided for convenience. It differs from the above function in that it takes an H5std_string for src and dst. - Deprecated due to inadequate functionality. | |
| virtual void | throwException (const H5std_string &func_name, const H5std_string &msg) const |
| For subclasses, H5File and Group, to throw appropriate exception. | |
| H5Location () | |
Public Member Functions inherited from H5::IdComponent | |
| void | incRefCount (const hid_t obj_id) const |
| Increment reference counter for a given id. | |
| void | incRefCount () const |
| Increment reference counter for the id of this object. | |
| void | decRefCount (const hid_t obj_id) const |
| Decrement reference counter for a given id. | |
| void | decRefCount () const |
| Decrement reference counter for the id of this object. | |
| int | getCounter (const hid_t obj_id) const |
| Returns the reference counter for a given id. | |
| int | getCounter () const |
| Returns the reference counter for the id of this object. | |
| H5I_type_t | getHDFObjType () const |
| Returns the type of the object. It is an overloaded function of the above function. | |
| IdComponent & | operator= (const IdComponent &rhs) |
| Assignment operator. | |
| void | setId (const hid_t new_id) |
| Sets the identifier of this object to a new value. | |
| virtual | ~IdComponent () |
| Noop destructor. | |
Protected Member Functions | |
| virtual | ~H5Location () |
| Noop destructor. | |
Additional Inherited Members | |
Static Public Member Functions inherited from H5::IdComponent | |
| static H5I_type_t | getHDFObjType (const hid_t obj_id) |
| Given an id, returns the type of the object. | |
| static hsize_t | getNumMembers (H5I_type_t type) |
| Returns the number of members of the given type. | |
| static bool | isValid (hid_t an_id) |
| Checks if the given ID is valid. | |
| static bool | typeExists (H5I_type_t type) |
| Queries if a given type is currently registered with the library. | |
It provides a collection of wrappers for the C functions that take a location identifier to specify the HDF5 object. The location identifier can be either file, group, dataset, attribute, or named datatype. Wrappers for H5A functions stay in H5Object.
| H5::H5Location::H5Location | ( | ) |
|
protectedvirtual |
| H5O_type_t H5::H5Location::childObjType | ( | const char * | objname | ) | const |
| objname | - IN: Name of the object |
H5O_TYPE_GROUP H5O_TYPE_DATASET H5O_TYPE_NAMED_DATATYPE For information, please refer to the H5Oget_info_by_name API in the HDF5 C Reference Manual. | H5::FileIException/H5::GroupIException/H5::LocationException | Exception will be thrown when:
|
| H5O_type_t H5::H5Location::childObjType | ( | const H5std_string & | objname | ) | const |
Returns the type of an object in this group, given the object's name.
| objname | - IN: Name of the object (H5std_string&) |
| H5::FileIException/H5::GroupIException/H5::LocationException |
| H5O_type_t H5::H5Location::childObjType | ( | hsize_t | index, |
| H5_index_t | index_type = H5_INDEX_NAME, |
||
| H5_iter_order_t | order = H5_ITER_INC, |
||
| const char * | objname = "." |
||
| ) | const |
| index | - IN: Position of the object |
| index_type | - IN: Type of the index, default to H5_INDEX_NAME |
| order | - IN: Traversing order, default to H5_ITER_INC |
| objname | - IN: Name of the object, default to "." |
H5O_TYPE_GROUP H5O_TYPE_DATASET H5O_TYPE_NAMED_DATATYPE For information, please refer to the H5Oget_info_by_idx API in the HDF5 C Reference Manual. | H5::FileIException/H5::GroupIException/H5::LocationException | Exception will be thrown when:
|
| unsigned H5::H5Location::childObjVersion | ( | const char * | objname | ) | const |
| objname | - IN: Name of the object |
H5O_VERSION_1 H5O_VERSION_2 | H5::FileIException/H5::GroupIException/H5::LocationException | Exception will be thrown when:
|
| unsigned H5::H5Location::childObjVersion | ( | const H5std_string & | objname | ) | const |
Returns the type of an object in this group, given the object's name.
| objname | - IN: Name of the object (H5std_string&) |
| H5::FileIException/H5::GroupIException/H5::LocationException |
| void H5::H5Location::copyLink | ( | const char * | src_name, |
| const char * | dst_name, | ||
| const LinkCreatPropList & | lcpl = LinkCreatPropList::DEFAULT, |
||
| const LinkAccPropList & | lapl = LinkAccPropList::DEFAULT |
||
| ) | const |
| src_name | - IN: Original name |
| dst_name | - IN: New name |
| lcpl | - IN: Link creation plist - default LinkCreatPropList::DEFAULT |
| lapl | - IN: Link access plist - default LinkAccPropList::DEFAULT |
| H5::FileIException | or H5::GroupIException |
References H5::PropList::getId().
| void H5::H5Location::copyLink | ( | const char * | src_name, |
| const Group & | dst, | ||
| const char * | dst_name, | ||
| const LinkCreatPropList & | lcpl = LinkCreatPropList::DEFAULT, |
||
| const LinkAccPropList & | lapl = LinkAccPropList::DEFAULT |
||
| ) | const |
| src_name | - IN: Original name |
| dst | - IN: Destination location |
| dst_name | - IN: New name |
| lcpl | - IN: Link creation plist - default LinkCreatPropList::DEFAULT |
| lapl | - IN: Link access plist - default LinkAccPropList::DEFAULT |
| H5::FileIException | or H5::GroupIException |
References H5::PropList::getId(), and H5::Group::getId().
| void H5::H5Location::copyLink | ( | const H5std_string & | src_name, |
| const Group & | dst, | ||
| const H5std_string & | dst_name, | ||
| const LinkCreatPropList & | lcpl = LinkCreatPropList::DEFAULT, |
||
| const LinkAccPropList & | lapl = LinkAccPropList::DEFAULT |
||
| ) | const |
| H5::FileIException | or H5::GroupIException |
| void H5::H5Location::copyLink | ( | const H5std_string & | src_name, |
| const H5std_string & | dst_name, | ||
| const LinkCreatPropList & | lcpl = LinkCreatPropList::DEFAULT, |
||
| const LinkAccPropList & | lapl = LinkAccPropList::DEFAULT |
||
| ) | const |
| H5::FileIException | or H5::GroupIException |
| DataSet H5::H5Location::createDataSet | ( | const char * | name, |
| const DataType & | data_type, | ||
| const DataSpace & | data_space, | ||
| const DSetCreatPropList & | dcpl = DSetCreatPropList::DEFAULT, |
||
| const DSetAccPropList & | dapl = DSetAccPropList::DEFAULT, |
||
| const LinkCreatPropList & | lcpl = LinkCreatPropList::DEFAULT |
||
| ) | const |
| name | - IN: Name of the dataset to create |
| data_type | - IN: Datatype of the dataset |
| data_space | - IN: Dataspace for the dataset |
| dcpl | - IN: Dataset creation properly list |
| lcpl | - IN: Link creation properly list |
| dapl | - IN: Dataset access properly list |
| H5::FileIException/H5::GroupIException/H5::LocationException |
References H5::DataType::getId(), H5::PropList::getId(), and H5::DataSpace::getId().
| DataSet H5::H5Location::createDataSet | ( | const H5std_string & | name, |
| const DataType & | data_type, | ||
| const DataSpace & | data_space, | ||
| const DSetCreatPropList & | create_plist = DSetCreatPropList::DEFAULT, |
||
| const DSetAccPropList & | dapl = DSetAccPropList::DEFAULT, |
||
| const LinkCreatPropList & | lcpl = LinkCreatPropList::DEFAULT |
||
| ) | const |
| Group H5::H5Location::createGroup | ( | const char * | name, |
| const LinkCreatPropList & | lcpl | ||
| ) | const |
| name | - IN: Name of the group to create |
| size_hint | - IN: Indicates the number of bytes to reserve for the names that will appear in the group |
| H5::FileIException/H5::GroupIException/H5::LocationException |
References H5::PropList::getId().
| Group H5::H5Location::createGroup | ( | const char * | name, |
| size_t | size_hint = 0 |
||
| ) | const |
| name | - IN: Name of the group to create |
| size_hint | - IN: Indicates the number of bytes to reserve for the names that will appear in the group |
| H5::FileIException/H5::GroupIException/H5::LocationException |
| Group H5::H5Location::createGroup | ( | const H5std_string & | name, |
| const LinkCreatPropList & | lcpl | ||
| ) | const |
| Group H5::H5Location::createGroup | ( | const H5std_string & | name, |
| size_t | size_hint = 0 |
||
| ) | const |
| void H5::H5Location::dereference | ( | const H5Location & | loc, |
| const void * | ref, | ||
| H5R_type_t | ref_type = H5R_OBJECT, |
||
| const PropList & | plist = PropList::DEFAULT |
||
| ) |
| loc | - IN: Location of the referenced object |
| ref | - IN: Reference pointer |
| ref_type | - IN: Reference type |
| plist | - IN: Property list - default to PropList::DEFAULT |
| H5::ReferenceException |
| bool H5::H5Location::exists | ( | const char * | name, |
| const LinkAccPropList & | lapl = LinkAccPropList::DEFAULT |
||
| ) | const |
| name | - IN: Searched name |
| lapl | - IN: Link access property list |
| H5::LocationException |
| bool H5::H5Location::exists | ( | const H5std_string & | name, |
| const LinkAccPropList & | lapl = LinkAccPropList::DEFAULT |
||
| ) | const |
| name | - IN: Searched name |
| lapl | - IN: Link access property list |
| H5::LocationException |
| void H5::H5Location::flush | ( | H5F_scope_t | scope | ) | const |
| scope | - IN: Specifies the scope of the flushing action, which can be either of these values:
|
| H5::LocationException |
| ssize_t H5::H5Location::getComment | ( | const char * | name, |
| size_t | buf_size, | ||
| char * | comment | ||
| ) | const |
| name | - IN: Name of the object |
| buf_size | - IN: Length of the comment to retrieve |
| comment | - OUT: Retrieved comment |
| H5::LocationException |
| H5std_string H5::H5Location::getComment | ( | const char * | name, |
| size_t | buf_size = 0 |
||
| ) | const |
| name | - IN: Name of the object |
| buf_size | - IN: Length of the comment to retrieve, default to 0 |
| H5::LocationException |
| H5std_string H5::H5Location::getComment | ( | const H5std_string & | name, |
| size_t | buf_size = 0 |
||
| ) | const |
| H5std_string H5::H5Location::getFileName | ( | ) | const |
| H5L_info_t H5::H5Location::getLinkInfo | ( | const char * | link_name, |
| const LinkAccPropList & | lapl = LinkAccPropList::DEFAULT |
||
| ) | const |
| link_name | - IN: Symbolic link to the object |
| size | - IN: Maximum number of characters of value to be returned |
| H5::FileIException/H5::GroupIException/H5::LocationException |
References H5::PropList::getId().
| H5L_info_t H5::H5Location::getLinkInfo | ( | const H5std_string & | link_name, |
| const LinkAccPropList & | lapl = LinkAccPropList::DEFAULT |
||
| ) | const |
| H5std_string H5::H5Location::getLinkval | ( | const char * | name, |
| size_t | size = 0 |
||
| ) | const |
| name | - IN: Symbolic link to the object |
| size | - IN: Maximum number of characters of value to be returned |
| H5::FileIException/H5::GroupIException/H5::LocationException |
| H5std_string H5::H5Location::getLinkval | ( | const H5std_string & | link_name, |
| size_t | size = 0 |
||
| ) | const |
| hsize_t H5::H5Location::getNumObjs | ( | ) | const |
| Deprecated |
| void H5::H5Location::getObjinfo | ( | const char * | grp_name, |
| H5_index_t | idx_type, | ||
| H5_iter_order_t | order, | ||
| hsize_t | idx, | ||
| H5O_info_t & | objinfo, | ||
| unsigned | fields = H5O_INFO_BASIC, |
||
| const LinkAccPropList & | lapl = LinkAccPropList::DEFAULT |
||
| ) | const |
| grp_name | - IN: Group name where the object belongs - char * |
| idx_type | - IN: Type of index |
| order | - IN: Order to traverse |
| idx | - IN: Object position |
| objinfo | - OUT: Struct containing the object info |
| fields | - IN: Indicates the group of information to be retrieved
|
| lapl | - IN: Link access property list |
H5O_INFO_BASIC (default) H5O_INFO_TIME H5O_INFO_NUM_ATTRS H5O_INFO_HDR H5O_INFO_META_SIZE H5O_INFO_ALL References H5::PropList::getId().
| void H5::H5Location::getObjinfo | ( | const char * | name, |
| H5G_stat_t & | statbuf | ||
| ) | const |
| void H5::H5Location::getObjinfo | ( | const char * | name, |
| H5O_info_t & | objinfo, | ||
| unsigned | fields = H5O_INFO_BASIC, |
||
| const LinkAccPropList & | lapl = LinkAccPropList::DEFAULT |
||
| ) | const |
| name | - IN: Name of the object to be queried - char * |
| objinfo | - OUT: Struct containing the object info |
| fields | - IN: Indicates the group of information to be retrieved
|
| lapl | - IN: Link access property list |
H5O_INFO_BASIC (default) H5O_INFO_TIME H5O_INFO_NUM_ATTRS H5O_INFO_HDR H5O_INFO_META_SIZE H5O_INFO_ALL References H5::PropList::getId().
| void H5::H5Location::getObjinfo | ( | const char * | name, |
| hbool_t | follow_link, | ||
| H5G_stat_t & | statbuf | ||
| ) | const |
| name | - IN: Name of the object |
| follow_link | - IN: Link flag |
| statbuf | - OUT: Buffer to return information about the object |
| H5::FileIException/H5::GroupIException/H5::LocationException |
| void H5::H5Location::getObjinfo | ( | const H5std_string & | grp_name, |
| H5_index_t | idx_type, | ||
| H5_iter_order_t | order, | ||
| hsize_t | idx, | ||
| H5O_info_t & | objinfo, | ||
| unsigned | fields = H5O_INFO_BASIC, |
||
| const LinkAccPropList & | lapl = LinkAccPropList::DEFAULT |
||
| ) | const |
| name | - IN: Name of the object to be queried - H5std_string |
| objinfo | - OUT: Struct containing the object info |
| fields | - IN: Indicates a group of information to be retrieved
|
| lapl | - IN: Link access property list |
| void H5::H5Location::getObjinfo | ( | const H5std_string & | name, |
| H5G_stat_t & | statbuf | ||
| ) | const |
| void H5::H5Location::getObjinfo | ( | const H5std_string & | name, |
| H5O_info_t & | objinfo, | ||
| unsigned | fields = H5O_INFO_BASIC, |
||
| const LinkAccPropList & | lapl = LinkAccPropList::DEFAULT |
||
| ) | const |
| name | - IN: Name of the object to be queried - H5std_string |
| objinfo | - OUT: Struct containing the object info |
| fields | - IN: Indicates the group of information to be retrieved
|
| lapl | - IN: Link access property list |
| void H5::H5Location::getObjinfo | ( | const H5std_string & | name, |
| hbool_t | follow_link, | ||
| H5G_stat_t & | statbuf | ||
| ) | const |
| void H5::H5Location::getObjinfo | ( | H5O_info_t & | objinfo, |
| unsigned | fields = H5O_INFO_BASIC |
||
| ) | const |
| objinfo | - OUT: Struct containing the object info |
| fields | - IN: Indicates the group of information to be retrieved |
H5O_INFO_BASIC (default) H5O_INFO_TIME H5O_INFO_NUM_ATTRS H5O_INFO_HDR H5O_INFO_META_SIZE H5O_INFO_ALL | H5std_string H5::H5Location::getObjnameByIdx | ( | hsize_t | idx | ) | const |
| idx | - IN: Transient index of the object |
| H5::FileIException/H5::GroupIException/H5::LocationException |
H5Location::getNumObjs. Note that this is a transient index; thus, an object may have a different index each time the group is opened. | ssize_t H5::H5Location::getObjnameByIdx | ( | hsize_t | idx, |
| char * | name, | ||
| size_t | size | ||
| ) | const |
| idx | - IN: Transient index of the object |
| name | - IN/OUT: Retrieved name of the object |
| size | - IN: Length to retrieve |
| H5::FileIException/H5::GroupIException/H5::LocationException |
H5Location::getNumObjs. Note that this is a transient index; thus, an object may have a different index each time the group is opened. | ssize_t H5::H5Location::getObjnameByIdx | ( | hsize_t | idx, |
| H5std_string & | name, | ||
| size_t | size | ||
| ) | const |
| H5G_obj_t H5::H5Location::getObjType | ( | void * | ref, |
| H5R_type_t | ref_type = H5R_OBJECT |
||
| ) | const |
| ref_type | - IN: Type of reference to query, valid values are:
|
| ref | - IN: Reference to query |
H5G_UNKNOWN - A failure occurs. (-1) H5G_GROUP - Object is a group. H5G_DATASET - Object is a dataset. H5G_TYPE Object - is a named datatype H5G_LINK - Object is a symbolic link. H5G_UDLINK - Object is a user-defined link. | H5::ReferenceException |
References H5::Exception::getDetailMsg().
| H5G_obj_t H5::H5Location::getObjTypeByIdx | ( | hsize_t | idx | ) | const |
| idx | - IN: Transient index of the object |
| H5::FileIException/H5::GroupIException/H5::LocationException |
| H5G_obj_t H5::H5Location::getObjTypeByIdx | ( | hsize_t | idx, |
| char * | type_name | ||
| ) | const |
| idx | - IN: Transient index of the object |
| type_name | - OUT: Object type in text |
| H5::FileIException/H5::GroupIException/H5::LocationException |
| H5G_obj_t H5::H5Location::getObjTypeByIdx | ( | hsize_t | idx, |
| H5std_string & | type_name | ||
| ) | const |
| idx | - IN: Transient index of the object |
| type_name | - OUT: Object type in text |
| H5::FileIException/H5::GroupIException/H5::LocationException |
| H5O_type_t H5::H5Location::getRefObjType | ( | void * | ref, |
| H5R_type_t | ref_type = H5R_OBJECT |
||
| ) | const |
| ref | - IN: Reference to query |
| ref_type | - IN: Type of reference to query, valid values are:
|
H5O_TYPE_UNKNOWN - Unknown object type (-1) H5O_TYPE_GROUP - Object is a group H5O_TYPE_DATASET - Object is a dataset H5O_TYPE_NAMED_DATATYPE - Object is a named datatype H5O_TYPE_NTYPES - Number of different object types | H5::ReferenceException |
References H5::Exception::getDetailMsg().
| DataSpace H5::H5Location::getRegion | ( | void * | ref, |
| H5R_type_t | ref_type = H5R_DATASET_REGION |
||
| ) | const |
| ref | - IN: Reference to get region of |
| ref_type | - IN: Type of reference to get region of - default |
| H5::ReferenceException |
References H5::f_DataSpace_setId(), and H5::Exception::getDetailMsg().
| int H5::H5Location::iterateElems | ( | const char * | name, |
| int * | idx, | ||
| H5G_iterate_t | op, | ||
| void * | op_data | ||
| ) |
| name | - IN : Name of group to iterate over |
| idx | - IN/OUT: Starting (IN) and ending (OUT) entry indices |
| op | - IN : User's function to operate on each entry |
| op_data | - IN/OUT: Data associated with the operation |
| H5::FileIException/H5::GroupIException/H5::LocationException |
| int H5::H5Location::iterateElems | ( | const H5std_string & | name, |
| int * | idx, | ||
| H5G_iterate_t | op, | ||
| void * | op_data | ||
| ) |
| void H5::H5Location::link | ( | const char * | curr_name, |
| const Group & | new_loc, | ||
| const char * | new_name, | ||
| const LinkCreatPropList & | lcpl = LinkCreatPropList::DEFAULT, |
||
| const LinkAccPropList & | lapl = LinkAccPropList::DEFAULT |
||
| ) | const |
| curr_name | - IN: Name of the existing object |
| new_loc | - IN: New group or root group |
| new_name | - IN: New name for the object |
| lcpl | - IN: Link creation plist - default to LinkCreatPropList::DEFAULT |
| lapl | - IN: Link access plist - default to LinkAccPropList::DEFAULT |
| H5::FileIException | or H5::GroupIException |
References H5::PropList::getId(), and H5::Group::getId().
| void H5::H5Location::link | ( | const char * | curr_name, |
| const hid_t | same_loc, | ||
| const char * | new_name, | ||
| const LinkCreatPropList & | lcpl = LinkCreatPropList::DEFAULT, |
||
| const LinkAccPropList & | lapl = LinkAccPropList::DEFAULT |
||
| ) | const |
| curr_name | - IN: Name of the existing object |
| loc_id | - IN: Group or root group ID, or H5L_SAME_LOC |
| new_name | - IN: New name for the link |
| lcpl | - IN: Link creation plist - default to LinkCreatPropList::DEFAULT |
| lapl | - IN: Link access plist - default to LinkAccPropList::DEFAULT |
| H5::FileIException | or H5::GroupIException |
References H5::PropList::getId().
| void H5::H5Location::link | ( | const char * | target_name, |
| const char * | link_name, | ||
| const LinkCreatPropList & | lcpl = LinkCreatPropList::DEFAULT, |
||
| const LinkAccPropList & | lapl = LinkAccPropList::DEFAULT |
||
| ) | const |
| target_name | - IN: Name of object, can be a non-existing object |
| link_name | - IN: Link name for the target name |
| lcpl | - IN: Link creation plist - default to LinkCreatPropList::DEFAULT |
| lapl | - IN: Link access plist - default to LinkAccPropList::DEFAULT |
| H5::FileIException | or H5::GroupIException |
References H5::PropList::getId().
| void H5::H5Location::link | ( | const H5std_string & | curr_name, |
| const Group & | new_loc, | ||
| const H5std_string & | new_name, | ||
| const LinkCreatPropList & | lcpl = LinkCreatPropList::DEFAULT, |
||
| const LinkAccPropList & | lapl = LinkAccPropList::DEFAULT |
||
| ) | const |
| H5::FileIException | or H5::GroupIException |
| void H5::H5Location::link | ( | const H5std_string & | curr_name, |
| const hid_t | same_loc, | ||
| const H5std_string & | new_name, | ||
| const LinkCreatPropList & | lcpl = LinkCreatPropList::DEFAULT, |
||
| const LinkAccPropList & | lapl = LinkAccPropList::DEFAULT |
||
| ) | const |
| H5::FileIException | or H5::GroupIException |
| void H5::H5Location::link | ( | const H5std_string & | target_name, |
| const H5std_string & | link_name, | ||
| const LinkCreatPropList & | lcpl = LinkCreatPropList::DEFAULT, |
||
| const LinkAccPropList & | lapl = LinkAccPropList::DEFAULT |
||
| ) | const |
| H5::FileIException | or H5::GroupIException |
| void H5::H5Location::link | ( | H5L_type_t | link_type, |
| const char * | curr_name, | ||
| const char * | new_name | ||
| ) | const |
| link_type | - IN: Link type; possible values are
|
| curr_name | - IN: Name of the existing object if link is a hard link; can be anything for the soft link |
| new_name | - IN: New name for the object |
| H5::FileIException/H5::GroupIException/H5::LocationException |
| void H5::H5Location::link | ( | H5L_type_t | link_type, |
| const H5std_string & | curr_name, | ||
| const H5std_string & | new_name | ||
| ) | const |
| void H5::H5Location::mount | ( | const char * | name, |
| const H5File & | child, | ||
| const PropList & | plist | ||
| ) | const |
| name | - IN: Name of the group |
| child | - IN: File to mount |
| plist | - IN: Property list to use |
| H5::FileIException | or H5::GroupIException |
References H5::PropList::getId(), and H5::H5File::getId().
| void H5::H5Location::mount | ( | const H5std_string & | name, |
| const H5File & | child, | ||
| const PropList & | plist | ||
| ) | const |
| void H5::H5Location::move | ( | const char * | src, |
| const char * | dst | ||
| ) | const |
| src | - IN: Object's original name |
| dst | - IN: Object's new name |
| H5::FileIException/H5::GroupIException/H5::LocationException |
| void H5::H5Location::move | ( | const H5std_string & | src, |
| const H5std_string & | dst | ||
| ) | const |
| void H5::H5Location::moveLink | ( | const char * | src_name, |
| const char * | dst_name, | ||
| const LinkCreatPropList & | lcpl = LinkCreatPropList::DEFAULT, |
||
| const LinkAccPropList & | lapl = LinkAccPropList::DEFAULT |
||
| ) | const |
| src_name | - IN: Original name |
| dst_name | - IN: New name |
| lcpl | - IN: Link creation plist - default LinkCreatPropList::DEFAULT |
| lapl | - IN: Link access plist - default LinkAccPropList::DEFAULT |
| H5::FileIException | or H5::GroupIException |
References H5::PropList::getId().
| void H5::H5Location::moveLink | ( | const char * | src_name, |
| const Group & | dst, | ||
| const char * | dst_name, | ||
| const LinkCreatPropList & | lcpl = LinkCreatPropList::DEFAULT, |
||
| const LinkAccPropList & | lapl = LinkAccPropList::DEFAULT |
||
| ) | const |
| src_name | - IN: Original name |
| dst | - IN: Destination location |
| dst_name | - IN: New name |
| lcpl | - IN: Link creation plist - default LinkCreatPropList::DEFAULT |
| lapl | - IN: Link access plist - default LinkAccPropList::DEFAULT |
| H5::FileIException | or H5::GroupIException |
References H5::PropList::getId(), and H5::Group::getId().
| void H5::H5Location::moveLink | ( | const H5std_string & | src_name, |
| const Group & | dst, | ||
| const H5std_string & | dst_name, | ||
| const LinkCreatPropList & | lcpl = LinkCreatPropList::DEFAULT, |
||
| const LinkAccPropList & | lapl = LinkAccPropList::DEFAULT |
||
| ) | const |
| H5::FileIException | or H5::GroupIException |
| void H5::H5Location::moveLink | ( | const H5std_string & | src_name, |
| const H5std_string & | dst_name, | ||
| const LinkCreatPropList & | lcpl = LinkCreatPropList::DEFAULT, |
||
| const LinkAccPropList & | lapl = LinkAccPropList::DEFAULT |
||
| ) | const |
| H5::FileIException | or H5::GroupIException |
| bool H5::H5Location::nameExists | ( | const char * | name, |
| const LinkAccPropList & | lapl = LinkAccPropList::DEFAULT |
||
| ) | const |
| name | - IN: Searched name |
| lapl | - IN: Link access property list |
| H5::LocationException |
References H5::PropList::getId().
| bool H5::H5Location::nameExists | ( | const H5std_string & | name, |
| const LinkAccPropList & | lapl = LinkAccPropList::DEFAULT |
||
| ) | const |
| name | - IN: Searched name |
| lapl | - IN: Link access property list |
| H5::LocationException |
| DataSet H5::H5Location::openDataSet | ( | const char * | name, |
| const DSetAccPropList & | dapl = DSetAccPropList::DEFAULT |
||
| ) | const |
| name | - IN: Name of the dataset to open |
| H5::FileIException/H5::GroupIException/H5::LocationException |
References H5::PropList::getId().
| DataSet H5::H5Location::openDataSet | ( | const H5std_string & | name, |
| const DSetAccPropList & | dapl = DSetAccPropList::DEFAULT |
||
| ) | const |
| Group H5::H5Location::openGroup | ( | const char * | name | ) | const |
| name | - IN: Name of the group to open |
| H5::FileIException/H5::GroupIException/H5::LocationException |
| Group H5::H5Location::openGroup | ( | const H5std_string & | name | ) | const |
| void H5::H5Location::reference | ( | void * | ref, |
| const char * | name, | ||
| const DataSpace & | dataspace, | ||
| H5R_type_t | ref_type = H5R_DATASET_REGION |
||
| ) | const |
| ref | - IN: Reference pointer |
| name | - IN: Name of the object to be referenced |
| dataspace | - IN: Dataspace with selection |
| ref_type | - IN: Type of reference to query, valid values are:
|
| H5::ReferenceException |
References H5::Exception::getDetailMsg(), and H5::DataSpace::getId().
| void H5::H5Location::reference | ( | void * | ref, |
| const char * | name, | ||
| H5R_type_t | ref_type = H5R_OBJECT |
||
| ) | const |
| ref | - IN: Reference pointer |
| name | - IN: Name of the object to be referenced |
| ref_type | - IN: Type of reference to query, valid values are:
|
| H5::ReferenceException |
References H5::Exception::getDetailMsg().
| void H5::H5Location::reference | ( | void * | ref, |
| const H5std_string & | name, | ||
| const DataSpace & | dataspace, | ||
| H5R_type_t | ref_type = H5R_DATASET_REGION |
||
| ) | const |
| ref | - IN: Reference pointer |
| name | - IN: Name of the object to be referenced |
| dataspace | - IN: Dataspace with selection |
| ref_type | - IN: Type of reference to query, valid values are:
|
| H5::ReferenceException |
References H5::Exception::getDetailMsg(), and H5::DataSpace::getId().
| void H5::H5Location::reference | ( | void * | ref, |
| const H5std_string & | name, | ||
| H5R_type_t | ref_type = H5R_OBJECT |
||
| ) | const |
| ref | - IN: Reference pointer |
| name | - IN: Name of the object to be referenced - H5std_string |
| ref_type | - IN: Type of reference to query, valid values are:
|
| void H5::H5Location::removeComment | ( | const char * | name | ) | const |
| name | - IN: Name of the object |
| H5::LocationException |
| void H5::H5Location::removeComment | ( | const H5std_string & | name | ) | const |
| void H5::H5Location::setComment | ( | const char * | comment | ) | const |
| void H5::H5Location::setComment | ( | const char * | name, |
| const char * | comment | ||
| ) | const |
| name | - IN: Name of the object |
| comment | - IN: New comment |
| H5::LocationException |
| void H5::H5Location::setComment | ( | const H5std_string & | comment | ) | const |
| void H5::H5Location::setComment | ( | const H5std_string & | name, |
| const H5std_string & | comment | ||
| ) | const |
|
virtual |
Invokes subclass' throwException.
| func_name | - Name of the function where failure occurs |
| msg | - Message describing the failure |
| H5::GroupIException |
Reimplemented in H5::H5File, and H5::Group.
| void H5::H5Location::unlink | ( | const char * | name, |
| const LinkAccPropList & | lapl = LinkAccPropList::DEFAULT |
||
| ) | const |
| name | - IN: Name of the object to be removed |
| H5::FileIException/H5::GroupIException/H5::LocationException |
References H5::PropList::getId().
| void H5::H5Location::unlink | ( | const H5std_string & | link_name, |
| const LinkAccPropList & | lapl = LinkAccPropList::DEFAULT |
||
| ) | const |
| void H5::H5Location::unmount | ( | const char * | name | ) | const |
| name | - IN: Name of the file to unmount |
| H5::FileIException/H5::GroupIException/H5::LocationException |
| void H5::H5Location::unmount | ( | const H5std_string & | name | ) | const |
|
The HDF Group Help Desk: | Copyright by The HDF Group |