summaryrefslogtreecommitdiffstats
path: root/src/H5Opublic.h
diff options
context:
space:
mode:
authorAllen Byrne <50328838+byrnHDF@users.noreply.github.com>2021-01-08 18:02:44 (GMT)
committerGitHub <noreply@github.com>2021-01-08 18:02:44 (GMT)
commit0e09b0b636b25bfe6226cc5ef5fa52e75383c32c (patch)
treeaeaeac3717b658ecc9b8ba882a022c199d89072a /src/H5Opublic.h
parent9e1739f76f42d5849a069a8ac86125a5f1d23edb (diff)
downloadhdf5-0e09b0b636b25bfe6226cc5ef5fa52e75383c32c.zip
hdf5-0e09b0b636b25bfe6226cc5ef5fa52e75383c32c.tar.gz
hdf5-0e09b0b636b25bfe6226cc5ef5fa52e75383c32c.tar.bz2
Keep doxygen comment length under 100 char line length (#247)
* OESS-98 convert plugin option to FetchContent, add tests * Fixes for pkcfg files because of plugin option * OESS-98 fix tools test for plugins * Keep doxygen comments under 100 chars long - format hint * Whitespace
Diffstat (limited to 'src/H5Opublic.h')
-rw-r--r--src/H5Opublic.h70
1 files changed, 39 insertions, 31 deletions
diff --git a/src/H5Opublic.h b/src/H5Opublic.h
index 9f2c64f..7473617 100644
--- a/src/H5Opublic.h
+++ b/src/H5Opublic.h
@@ -26,9 +26,9 @@
#define _H5Opublic_H
/* Public headers needed by this file */
-#include "H5public.h" /* Generic Functions */
-#include "H5Ipublic.h" /* IDs */
-#include "H5Lpublic.h" /* Links */
+#include "H5public.h" /* Generic Functions */
+#include "H5Ipublic.h" /* IDs */
+#include "H5Lpublic.h" /* Links */
/*****************/
/* Public Macros */
@@ -109,10 +109,10 @@
/* Types of objects in file */
typedef enum H5O_type_t {
- H5O_TYPE_UNKNOWN = -1, /* Unknown object type */
- H5O_TYPE_GROUP, /* Object is a group */
- H5O_TYPE_DATASET, /* Object is a dataset */
- H5O_TYPE_NAMED_DATATYPE, /* Object is a named data type */
+ H5O_TYPE_UNKNOWN = -1, /* Unknown object type */
+ H5O_TYPE_GROUP, /* Object is a group */
+ H5O_TYPE_DATASET, /* Object is a dataset */
+ H5O_TYPE_NAMED_DATATYPE, /* Object is a named data type */
H5O_TYPE_MAP, /* Object is a map */
H5O_TYPE_NTYPES /* Number of different object types (must be last!) */
} H5O_type_t;
@@ -293,9 +293,10 @@ H5_DLL hid_t H5Oopen_by_token(hid_t loc_id, H5O_token_t token);
* \details H5Open_by_idx() opens the nth object in the group specified by \p loc_id
* and \p group_name.
*
- * \p loc_id specifies a location identifier. \p group_name specifies the group relative to
- * \p loc_id in which the object can be found. If \p loc_id fully specifies the group
- * in which the object resides, \p group_name can be a dot (.).
+ * \p loc_id specifies a location identifier.
+ * \p group_name specifies the group relative to \p loc_id in which the object can be found.
+ * If \p loc_id fully specifies the group in which the object resides,
+ * \p group_name can be a dot (.).
*
* The specific object to be opened within the group is specified by the three parameters:
* \p idx_type, \p order and \p n.
@@ -345,8 +346,10 @@ H5_DLL hid_t H5Oopen_by_idx_async(const char *app_file, const char *app_func, un
* \param[in] name The name of the link to check
* \lapl_id
*
- * \return Returns a positive value if the object pointed to by the \p loc_id and \p name combination exists.
- * \return Returns 0 if the object pointed to by the \p loc_id and \p name combination does not exist.
+ * \return Returns a positive value if the object pointed to by
+ * the \p loc_id and \p name combination exists.
+ * \return Returns 0 if the object pointed to by
+ * the \p loc_id and \p name combination does not exist.
* \return Returns a negatvie value when the function fails.
*
* \details H5Oexists_by_name() allows an application to determine whether
@@ -445,8 +448,8 @@ H5_DLL htri_t H5Oexists_by_name(hid_t loc_id, const char *name, hid_t lapl_id);
* \snippet this H5O_info2_t_snip
*
* Note the following about H5O_info2_t :
- * - Of the four time fields (\c atime, \c mtime, \c ctime, and \c btime) only \c ctime has been
- *implemented.
+ * - Of the four time fields (\c atime, \c mtime, \c ctime, and \c btime)
+ * only \c ctime has been implemented.
* - The \c atime value is the last time the object was read or written.
* - The \c mtime value is the last time the raw data in the object was changed.
* - The \c ctime value is the last time the metadata for the object was changed.
@@ -515,8 +518,8 @@ H5_DLL herr_t H5Oget_info3(hid_t loc_id, H5O_info2_t *oinfo, unsigned fields);
* \snippet this H5O_info2_t_snip
*
* Note the following about H5O_info2_t :
- * - Of the four time fields (\c atime, \c mtime, \c ctime, and \c btime) only \c ctime has been
- *implemented.
+ * - Of the four time fields (\c atime, \c mtime, \c ctime, and \c btime)
+ * only \c ctime has been implemented.
* - The \c atime value is the last time the object was read or written.
* - The \c mtime value is the last time the raw data in the object was changed.
* - The \c ctime value is the last time the metadata for the object was changed.
@@ -593,8 +596,8 @@ H5_DLL herr_t H5Oget_info_by_name_async(const char *app_file, const char *app_fu
* \snippet this H5O_info2_t_snip
*
* Note the following about H5O_info2_t :
- * - Of the four time fields (\c atime, \c mtime, \c ctime, and \c btime) only \c ctime has been
- *implemented.
+ * - Of the four time fields (\c atime, \c mtime, \c ctime, and \c btime)
+ * only \c ctime has been implemented.
* - The \c atime value is the last time the object was read or written.
* - The \c mtime value is the last time the raw data in the object was changed.
* - The \c ctime value is the last time the metadata for the object was changed.
@@ -1886,13 +1889,13 @@ typedef struct H5O_stat_t {
/* (For H5Oget_info/H5Oget_info_by_name/H5Oget_info_by_idx versions 1 & 2) */
typedef struct H5O_info1_t {
unsigned long fileno; /* File number that object is located in */
- haddr_t addr; /* Object address in file */
+ haddr_t addr; /* Object address in file */
H5O_type_t type; /* Basic object type (group, dataset, etc.) */
unsigned rc; /* Reference count of object */
- time_t atime; /* Access time */
- time_t mtime; /* Modification time */
- time_t ctime; /* Change time */
- time_t btime; /* Birth time */
+ time_t atime; /* Access time */
+ time_t mtime; /* Modification time */
+ time_t ctime; /* Change time */
+ time_t btime; /* Birth time */
hsize_t num_attrs; /* # of attributes attached to object */
H5O_hdr_info_t hdr; /* Object header information */
/* Extra metadata storage for obj & attributes */
@@ -1985,8 +1988,8 @@ H5_DLL hid_t H5Oopen_by_addr(hid_t loc_id, haddr_t addr);
* \snippet this H5O_info1_t_snip
*
* Note the following about H5O_info1_t :
- * - Of the four time fields (\c atime, \c mtime, \c ctime, and \c btime) only \c ctime has been
- *implemented.
+ * - Of the four time fields (\c atime, \c mtime, \c ctime, and \c btime)
+ * only \c ctime has been implemented.
* - The \c atime value is the last time the object was read or written.
* - The \c mtime value is the last time the raw data in the object was changed.
* - The \c ctime value is the last time the metadata for the object was changed.
@@ -2022,12 +2025,17 @@ H5_DLL hid_t H5Oopen_by_addr(hid_t loc_id, haddr_t addr);
* will force metadata entries to be evicted from the cache,
* thus freeing the memory associated with the entries.
*
- * \version 1.10.5 The macro #H5Oget_info was removed and the function H5Oget_info1() was copied to
- *H5Oget_info(). \version 1.10.3 Function H5Oget_info() was copied to H5Oget_info1(), and the macro
- *#H5Oget_info was created. \version 1.8.15 Added a note about the valid values for the \c version field in
- *the H5O_hdr_info_t structure. \version 1.8.11 Fortran subroutine introduced in this release. \version 1.8.10
- *Added #H5O_type_t structure to the Description section. \n Separated H5O_hdr_info_t structure from
- *#H5O_info_t in the Description section. \n Clarified the definition and implementation of the time fields.
+ * \version 1.10.5 The macro #H5Oget_info was removed and the function
+ * H5Oget_info1() was copied to H5Oget_info().
+ * \version 1.10.3 Function H5Oget_info() was copied to H5Oget_info1(),
+ * and the macro #H5Oget_info was created.
+ * \version 1.8.15 Added a note about the valid values for the \c version
+ * field in the H5O_hdr_info_t structure.
+ * \version 1.8.11 Fortran subroutine introduced in this release.
+ * \version 1.8.10 Added #H5O_type_t structure to the Description section. \n
+ * Separated H5O_hdr_info_t structure from #H5O_info_t in the
+ * Description section. \n
+ * Clarified the definition and implementation of the time fields.
*
* \since 1.8.0
*