diff options
author | lrknox <lrknox@users.noreply.github.com> | 2023-07-21 00:49:17 (GMT) |
---|---|---|
committer | lrknox <lrknox@users.noreply.github.com> | 2023-07-21 00:49:17 (GMT) |
commit | 175161c045ec8f1cc69b22030e416b60f40d5343 (patch) | |
tree | 9141df9563c2079e5b21245b7b5ca7e77a11066a /group___h5_o.html | |
parent | c5642bdd325aaecbe7da51c4ecb02b2347867560 (diff) | |
download | hdf5-175161c045ec8f1cc69b22030e416b60f40d5343.zip hdf5-175161c045ec8f1cc69b22030e416b60f40d5343.tar.gz hdf5-175161c045ec8f1cc69b22030e416b60f40d5343.tar.bz2 |
deploy: 1706355ee10cdad20b79603b3f39935601c5fff0
Diffstat (limited to 'group___h5_o.html')
-rw-r--r-- | group___h5_o.html | 86 |
1 files changed, 43 insertions, 43 deletions
diff --git a/group___h5_o.html b/group___h5_o.html index 3f77cb5..425beeb 100644 --- a/group___h5_o.html +++ b/group___h5_o.html @@ -37,7 +37,7 @@ <td id="projectlogo"><img alt="Logo" src="HDFG-logo.png"/></td> <td id="projectalign" style="padding-left: 0.5em;"> <div id="projectname"><a href="https://www.hdfgroup.org">HDF5</a> -  <span id="projectnumber">1.15.0.800edda</span> +  <span id="projectnumber">1.15.0.1706355</span> </div> <div id="projectbrief">API Reference</div> </td> @@ -408,7 +408,7 @@ Functions</h2></td></tr> <tr class="memdesc:ga0908be309da1fb4f771c1e264fac22ae"><td class="mdescLeft"> </td><td class="mdescRight">Prevents metadata entries for an HDF5 object from being flushed from the metadata cache to storage. <a href="group___h5_o.html#ga0908be309da1fb4f771c1e264fac22ae">More...</a><br /></td></tr> <tr class="separator:ga0908be309da1fb4f771c1e264fac22ae"><td class="memSeparator" colspan="2"> </td></tr> <tr class="memitem:ga21014920bdabf6973e233796d7174156"><td class="memItemLeft" align="right" valign="top"><a class="el" href="_h5public_8h.html#a3b079ecf932a5c599499cf7e298af160">herr_t</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="group___h5_o.html#ga21014920bdabf6973e233796d7174156">H5Oenable_mdc_flushes</a> (<a class="el" href="_h5_ipublic_8h.html#a0045db7ff9c22ad35db6ae91662e1943">hid_t</a> object_id)</td></tr> -<tr class="memdesc:ga21014920bdabf6973e233796d7174156"><td class="mdescLeft"> </td><td class="mdescRight">Enables flushing of dirty metadata entries from a file’s metadata cache. <a href="group___h5_o.html#ga21014920bdabf6973e233796d7174156">More...</a><br /></td></tr> +<tr class="memdesc:ga21014920bdabf6973e233796d7174156"><td class="mdescLeft"> </td><td class="mdescRight">Enables flushing of dirty metadata entries from a file's metadata cache. <a href="group___h5_o.html#ga21014920bdabf6973e233796d7174156">More...</a><br /></td></tr> <tr class="separator:ga21014920bdabf6973e233796d7174156"><td class="memSeparator" colspan="2"> </td></tr> <tr class="memitem:gab2fa388aadd1ff154ee150cbb4884c1c"><td class="memItemLeft" align="right" valign="top"><a class="el" href="_h5public_8h.html#a3b079ecf932a5c599499cf7e298af160">herr_t</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="group___h5_o.html#gab2fa388aadd1ff154ee150cbb4884c1c">H5Oare_mdc_flushes_disabled</a> (<a class="el" href="_h5_ipublic_8h.html#a0045db7ff9c22ad35db6ae91662e1943">hid_t</a> object_id, <a class="el" href="_h5public_8h.html#ad470b00eccd2115c707c02de5fa1120d">hbool_t</a> *are_disabled)</td></tr> <tr class="memdesc:gab2fa388aadd1ff154ee150cbb4884c1c"><td class="mdescLeft"> </td><td class="mdescRight">Retrieves comment for specified object. <a href="group___h5_o.html#gab2fa388aadd1ff154ee150cbb4884c1c">More...</a><br /></td></tr> @@ -577,7 +577,7 @@ Functions</h2></td></tr> <dd> Returns a non-negative value if successful; otherwise, returns a negative value.</dd></dl> <p><a class="el" href="group___h5_o.html#gab2fa388aadd1ff154ee150cbb4884c1c" title="Retrieves comment for specified object.">H5Oare_mdc_flushes_disabled()</a> determines if an HDF5 object (dataset, group, committed datatype) has had flushes of metadata entries disabled.</p> -<p>The <a class="el" href="group___h5_o.html#ga21014920bdabf6973e233796d7174156" title="Enables flushing of dirty metadata entries from a file’s metadata cache.">H5Oenable_mdc_flushes()</a>, <a class="el" href="group___h5_o.html#ga0908be309da1fb4f771c1e264fac22ae" title="Prevents metadata entries for an HDF5 object from being flushed from the metadata cache to storage.">H5Odisable_mdc_flushes()</a> and associated flush functions can be used to control the flushing of entries from a file’s metadata cache. Metadata cache entries can be controlled at both the individual HDF5 object level (datasets, groups, committed datatypes) and the entire metadata cache level.</p> +<p>The <a class="el" href="group___h5_o.html#ga21014920bdabf6973e233796d7174156" title="Enables flushing of dirty metadata entries from a file's metadata cache.">H5Oenable_mdc_flushes()</a>, <a class="el" href="group___h5_o.html#ga0908be309da1fb4f771c1e264fac22ae" title="Prevents metadata entries for an HDF5 object from being flushed from the metadata cache to storage.">H5Odisable_mdc_flushes()</a> and associated flush functions can be used to control the flushing of entries from a file's metadata cache. Metadata cache entries can be controlled at both the individual HDF5 object level (datasets, groups, committed datatypes) and the entire metadata cache level.</p> <dl class="section note"><dt>Note</dt><dd>HDF5 objects include datasets, groups, and committed datatypes. Only <a class="el" href="_h5_ipublic_8h.html#a0045db7ff9c22ad35db6ae91662e1943">hid_t</a> identifiers that represent these objects can be passed to the function. </dd> <dd> Passing in a <a class="el" href="_h5_ipublic_8h.html#a0045db7ff9c22ad35db6ae91662e1943">hid_t</a> identifier that represents any other HDF5 entity is considered an error. </dd> @@ -685,8 +685,8 @@ It is an error to pass an HDF5 file identifier (obtained from <a class="el" href </dl> <dl class="section return"><dt>Returns</dt><dd>Returns a non-negative value if successful; otherwise, returns a negative value.</dd></dl> <p><a class="el" href="group___h5_o.html#gaa94449be6f67f499be5ddd3fc44f4225" title="Copies an object in an HDF5 file.">H5Ocopy()</a> copies the group, dataset or committed datatype specified by <code>src_name</code> from the file or group specified by <code>src_loc_id</code> to the destination location <code>dst_loc_id</code>.</p> -<p>The destination location, as specified in dst_loc_id, may be a group in the current file or a location in a different file. If dst_loc_id is a file identifier, the copy will be placed in that file’s root group.</p> -<p>The copy will be created with the path specified in <code>dst_name</code>, which must not pre-exist in the destination location. If <code>dst_name</code> already exists at the location <code>dst_loc_id</code>, <a class="el" href="group___h5_o.html#gaa94449be6f67f499be5ddd3fc44f4225" title="Copies an object in an HDF5 file.">H5Ocopy()</a> will fail. If <code>dst_name</code> is an absolute path, the copy will be created relative to the file’s root group.</p> +<p>The destination location, as specified in dst_loc_id, may be a group in the current file or a location in a different file. If dst_loc_id is a file identifier, the copy will be placed in that file's root group.</p> +<p>The copy will be created with the path specified in <code>dst_name</code>, which must not pre-exist in the destination location. If <code>dst_name</code> already exists at the location <code>dst_loc_id</code>, <a class="el" href="group___h5_o.html#gaa94449be6f67f499be5ddd3fc44f4225" title="Copies an object in an HDF5 file.">H5Ocopy()</a> will fail. If <code>dst_name</code> is an absolute path, the copy will be created relative to the file's root group.</p> <p>The copy of the object is created with the property lists specified by <code>ocpypl_id</code> and <code>lcpl_id</code>. <a class="el" href="_h5_ppublic_8h.html#afa85e97bfbf9bf1c58e39263846c568f">H5P_DEFAULT</a> can be passed in for these property lists. The default behavior:</p> <ul> <li>of the link creation property list is to NOT create intermediate groups.</li> @@ -746,8 +746,8 @@ It is an error to pass an HDF5 file identifier (obtained from <a class="el" href </dl> <dl class="section return"><dt>Returns</dt><dd>Returns a non-negative value if successful; otherwise, returns a negative value.</dd></dl> <p><a class="el" href="group___h5_o.html#ga60c20da5e244c28a653d4fa23d316b44" title="Decrements an object reference count.">H5Odecr_refcount()</a> decrements the hard link reference count for an object. It should be used any time a user-defined link that references an object by address is deleted. In general, <a class="el" href="group___h5_o.html#ga2086bad6c3cd2a711c306a48c093ff55" title="Increments an object reference count.">H5Oincr_refcount()</a> will have been used previously, when the link was created.</p> -<p>An object’s reference count is the number of hard links in the file that point to that object. See the “Programming Model” section of the HDF5 Groups chapter in the <em><a class="el" href="_u_g.html">HDF5 User Guide</a></em> for a more complete discussion of reference counts.</p> -<p>If a user application needs to determine an object’s reference count, an <a class="el" href="group___h5_o.html#gaf4f302a33faba9e1c2b5f64c62ca4ed5">H5Oget_info()</a> call is required; the reference count is returned in the <code>rc</code> field of the <a class="el" href="_h5version_8h.html#a5f76b0cdd6d68d61f11e46d4f06e50d4">H5O_info_t</a> <code>struct</code>.</p> +<p>An object's reference count is the number of hard links in the file that point to that object. See the “Programming Model” section of the HDF5 Groups chapter in the <em><a class="el" href="_u_g.html">HDF5 User Guide</a></em> for a more complete discussion of reference counts.</p> +<p>If a user application needs to determine an object's reference count, an <a class="el" href="group___h5_o.html#gaf4f302a33faba9e1c2b5f64c62ca4ed5">H5Oget_info()</a> call is required; the reference count is returned in the <code>rc</code> field of the <a class="el" href="_h5version_8h.html#a5f76b0cdd6d68d61f11e46d4f06e50d4">H5O_info_t</a> <code>struct</code>.</p> <dl class="section warning"><dt>Warning</dt><dd>This function must be used with care! </dd> <dd> Improper use can lead to inaccessible data, wasted space in the file, or <b><em>file corruption</em></b>.</dd></dl> @@ -781,10 +781,10 @@ Improper use can lead to inaccessible data, wasted space in the file, or <b><em> </dd> </dl> <dl class="section return"><dt>Returns</dt><dd>Returns a non-negative value if successful; otherwise, returns a negative value.</dd></dl> -<p><a class="el" href="group___h5_o.html#ga0908be309da1fb4f771c1e264fac22ae" title="Prevents metadata entries for an HDF5 object from being flushed from the metadata cache to storage.">H5Odisable_mdc_flushes()</a>, <a class="el" href="group___h5_o.html#ga21014920bdabf6973e233796d7174156" title="Enables flushing of dirty metadata entries from a file’s metadata cache.">H5Oenable_mdc_flushes()</a> and associated flush functions can be used to control the flushing of entries from a file’s metadata cache.</p> -<p>This function prevents an object’s or cache’s dirty metadata entries from being flushed from the cache by the usual cache eviction/flush policy. Instead, users must manually flush the cache or entries for individual objects via the appropriate <a class="el" href="group___h5_f.html#gae686870f0a276c4d06bbc667b2c24124" title="Flushes all buffers associated with a file to storage.">H5Fflush()</a>, <a class="el" href="group___h5_d.html#ga4a2175a62baa1e35ad2467bb1fdff1f7" title="Flushes all buffers associated with a dataset to disk.">H5Dflush()</a>, <a class="el" href="group___h5_g.html#ga1d55dbf931f8003bb329c4340b8fe4d6" title="Flushes all buffers associated with a group to disk.">H5Gflush()</a>, <a class="el" href="group___h5_t.html#gafd60389b49e1e5e6f37caffbe6cbf6e5" title="Flushes all buffers associated with a committed datatype to disk.">H5Tflush()</a>, and <a class="el" href="group___h5_o.html#gad99f35048cba4534b6393214684f090f" title="Flushes all buffers associated with an HDF5 object to disk.">H5Oflush()</a> calls.</p> +<p><a class="el" href="group___h5_o.html#ga0908be309da1fb4f771c1e264fac22ae" title="Prevents metadata entries for an HDF5 object from being flushed from the metadata cache to storage.">H5Odisable_mdc_flushes()</a>, <a class="el" href="group___h5_o.html#ga21014920bdabf6973e233796d7174156" title="Enables flushing of dirty metadata entries from a file's metadata cache.">H5Oenable_mdc_flushes()</a> and associated flush functions can be used to control the flushing of entries from a file's metadata cache.</p> +<p>This function prevents an object's or cache's dirty metadata entries from being flushed from the cache by the usual cache eviction/flush policy. Instead, users must manually flush the cache or entries for individual objects via the appropriate <a class="el" href="group___h5_f.html#gae686870f0a276c4d06bbc667b2c24124" title="Flushes all buffers associated with a file to storage.">H5Fflush()</a>, <a class="el" href="group___h5_d.html#ga4a2175a62baa1e35ad2467bb1fdff1f7" title="Flushes all buffers associated with a dataset to disk.">H5Dflush()</a>, <a class="el" href="group___h5_g.html#ga1d55dbf931f8003bb329c4340b8fe4d6" title="Flushes all buffers associated with a group to disk.">H5Gflush()</a>, <a class="el" href="group___h5_t.html#gafd60389b49e1e5e6f37caffbe6cbf6e5" title="Flushes all buffers associated with a committed datatype to disk.">H5Tflush()</a>, and <a class="el" href="group___h5_o.html#gad99f35048cba4534b6393214684f090f" title="Flushes all buffers associated with an HDF5 object to disk.">H5Oflush()</a> calls.</p> <p>Metadata cache entries can be controlled at both the individual HDF5 object level (datasets, groups, committed datatypes) and the entire metadata cache level.</p> -<dl class="section note"><dt>Note</dt><dd>HDF5 objects include datasets, groups, and committed datatypes. Only <a class="el" href="_h5_ipublic_8h.html#a0045db7ff9c22ad35db6ae91662e1943">hid_t</a> identifiers that represent these objects can be passed to the function. Passing in a <a class="el" href="_h5_ipublic_8h.html#a0045db7ff9c22ad35db6ae91662e1943">hid_t</a> identifier that represents any other HDF5 entity is considered an error. It is an error to pass an HDF5 file identifier (obtained from <a class="el" href="group___h5_f.html#gaa3f4f877b9bb591f3880423ed2bf44bc" title="Opens an existing HDF5 file.">H5Fopen()</a> or <a class="el" href="group___h5_f.html#gae64b51ee9ac0781bc4ccc599d98387f4" title="Creates an HDF5 file.">H5Fcreate()</a>) to this function. Misuse of this function can cause the cache to exhaust available memory. Objects can be returned to the default automatic flush behavior with <a class="el" href="group___h5_o.html#ga21014920bdabf6973e233796d7174156" title="Enables flushing of dirty metadata entries from a file’s metadata cache.">H5Oenable_mdc_flushes()</a>. Flush prevention only pertains to new or dirty metadata entries. Clean entries can be evicted from the cache. Calling this function on an object that has already had flushes disabled will return an error.</dd></dl> +<dl class="section note"><dt>Note</dt><dd>HDF5 objects include datasets, groups, and committed datatypes. Only <a class="el" href="_h5_ipublic_8h.html#a0045db7ff9c22ad35db6ae91662e1943">hid_t</a> identifiers that represent these objects can be passed to the function. Passing in a <a class="el" href="_h5_ipublic_8h.html#a0045db7ff9c22ad35db6ae91662e1943">hid_t</a> identifier that represents any other HDF5 entity is considered an error. It is an error to pass an HDF5 file identifier (obtained from <a class="el" href="group___h5_f.html#gaa3f4f877b9bb591f3880423ed2bf44bc" title="Opens an existing HDF5 file.">H5Fopen()</a> or <a class="el" href="group___h5_f.html#gae64b51ee9ac0781bc4ccc599d98387f4" title="Creates an HDF5 file.">H5Fcreate()</a>) to this function. Misuse of this function can cause the cache to exhaust available memory. Objects can be returned to the default automatic flush behavior with <a class="el" href="group___h5_o.html#ga21014920bdabf6973e233796d7174156" title="Enables flushing of dirty metadata entries from a file's metadata cache.">H5Oenable_mdc_flushes()</a>. Flush prevention only pertains to new or dirty metadata entries. Clean entries can be evicted from the cache. Calling this function on an object that has already had flushes disabled will return an error.</dd></dl> <dl class="section since"><dt>Since</dt><dd>1.10.0 </dd></dl> </div> @@ -805,7 +805,7 @@ Improper use can lead to inaccessible data, wasted space in the file, or <b><em> </table> </div><div class="memdoc"> -<p>Enables flushing of dirty metadata entries from a file’s metadata cache. </p> +<p>Enables flushing of dirty metadata entries from a file's metadata cache. </p> <hr /> <dl class="params"><dt>Parameters</dt><dd> <table class="params"> @@ -814,10 +814,10 @@ Improper use can lead to inaccessible data, wasted space in the file, or <b><em> </dd> </dl> <dl class="section return"><dt>Returns</dt><dd>Returns a non-negative value if successful; otherwise, returns a negative value.</dd></dl> -<p><a class="el" href="group___h5_o.html#ga21014920bdabf6973e233796d7174156" title="Enables flushing of dirty metadata entries from a file’s metadata cache.">H5Oenable_mdc_flushes()</a>, <a class="el" href="group___h5_o.html#ga0908be309da1fb4f771c1e264fac22ae" title="Prevents metadata entries for an HDF5 object from being flushed from the metadata cache to storage.">H5Odisable_mdc_flushes()</a> and associated flush functions can be used to control the flushing of entries from a file’s metadata cache.</p> -<p>This function allows an object or cache’s dirty metadata entries to be flushed from the cache by the usual cache eviction/flush policy.</p> +<p><a class="el" href="group___h5_o.html#ga21014920bdabf6973e233796d7174156" title="Enables flushing of dirty metadata entries from a file's metadata cache.">H5Oenable_mdc_flushes()</a>, <a class="el" href="group___h5_o.html#ga0908be309da1fb4f771c1e264fac22ae" title="Prevents metadata entries for an HDF5 object from being flushed from the metadata cache to storage.">H5Odisable_mdc_flushes()</a> and associated flush functions can be used to control the flushing of entries from a file's metadata cache.</p> +<p>This function allows an object or cache's dirty metadata entries to be flushed from the cache by the usual cache eviction/flush policy.</p> <p>Metadata cache entries can be controlled at both the individual HDF5 object level (datasets, groups, committed datatypes) and the entire metadata cache level.</p> -<dl class="section note"><dt>Note</dt><dd>HDF5 objects include datasets, groups, and committed datatypes. Only <a class="el" href="_h5_ipublic_8h.html#a0045db7ff9c22ad35db6ae91662e1943">hid_t</a> identifiers that represent these objects can be passed to the function. Passing in a <a class="el" href="_h5_ipublic_8h.html#a0045db7ff9c22ad35db6ae91662e1943">hid_t</a> identifier that represents any other HDF5 entity is considered an error. It is an error to pass an HDF5 file identifier (obtained from <a class="el" href="group___h5_f.html#gaa3f4f877b9bb591f3880423ed2bf44bc" title="Opens an existing HDF5 file.">H5Fopen()</a> or <a class="el" href="group___h5_f.html#gae64b51ee9ac0781bc4ccc599d98387f4" title="Creates an HDF5 file.">H5Fcreate()</a>) to this function. Using this function on an object that has not had flushes disabled is considered an error. The state of an object can be determined with <a class="el" href="group___h5_o.html#gab2fa388aadd1ff154ee150cbb4884c1c" title="Retrieves comment for specified object.">H5Oare_mdc_flushes_disabled()</a>. An object will be returned to the default flush algorithm when it is closed. All objects will be returned to the default flush algorithm when the file is closed. An object’s entries will not necessarily be flushed as a result of calling this function.</dd></dl> +<dl class="section note"><dt>Note</dt><dd>HDF5 objects include datasets, groups, and committed datatypes. Only <a class="el" href="_h5_ipublic_8h.html#a0045db7ff9c22ad35db6ae91662e1943">hid_t</a> identifiers that represent these objects can be passed to the function. Passing in a <a class="el" href="_h5_ipublic_8h.html#a0045db7ff9c22ad35db6ae91662e1943">hid_t</a> identifier that represents any other HDF5 entity is considered an error. It is an error to pass an HDF5 file identifier (obtained from <a class="el" href="group___h5_f.html#gaa3f4f877b9bb591f3880423ed2bf44bc" title="Opens an existing HDF5 file.">H5Fopen()</a> or <a class="el" href="group___h5_f.html#gae64b51ee9ac0781bc4ccc599d98387f4" title="Creates an HDF5 file.">H5Fcreate()</a>) to this function. Using this function on an object that has not had flushes disabled is considered an error. The state of an object can be determined with <a class="el" href="group___h5_o.html#gab2fa388aadd1ff154ee150cbb4884c1c" title="Retrieves comment for specified object.">H5Oare_mdc_flushes_disabled()</a>. An object will be returned to the default flush algorithm when it is closed. All objects will be returned to the default flush algorithm when the file is closed. An object's entries will not necessarily be flushed as a result of calling this function.</dd></dl> <dl class="section since"><dt>Since</dt><dd>1.10.0 </dd></dl> </div> @@ -883,7 +883,7 @@ Returns a negative value when the function fails.</dd></dl> <li>And finally, if the link <code>datasetD</code> exists, use H5Oexists_by_name to verify that <code>group1/group2/softlink_to_group3/datasetD</code> resolves to an object.</li> </ul> </dd></dl> -<dl class="section user"><dt></dt><dd>If the link to be verified is specified with an absolute path, the same approach should be used, but starting with the first link in the file’s root group. For instance, if <code>datasetD</code> were in <code>/group1/group2/softlink_to_group3</code>, the first call to <a class="el" href="group___h5_l.html#ga171be6e41dc1a464edc402df0ebdf801" title="Determines whether a link with the specified name exists in a group.">H5Lexists()</a> would have name set to <code>/group1</code>.</dd></dl> +<dl class="section user"><dt></dt><dd>If the link to be verified is specified with an absolute path, the same approach should be used, but starting with the first link in the file's root group. For instance, if <code>datasetD</code> were in <code>/group1/group2/softlink_to_group3</code>, the first call to <a class="el" href="group___h5_l.html#ga171be6e41dc1a464edc402df0ebdf801" title="Determines whether a link with the specified name exists in a group.">H5Lexists()</a> would have name set to <code>/group1</code>.</dd></dl> <dl class="section user"><dt></dt><dd>Note that this is an outline and does not include all the necessary details. Depending on circumstances, for example, an application may need to verify the type of an object also.</dd></dl> <dl class="section warning"><dt>Warning</dt><dd><b>Failure Modes:</b> </dd> <dd> @@ -928,9 +928,9 @@ Note that verifying the existence of an object within an HDF5 file is a multiste <dl class="section note"><dt>Note</dt><dd>HDF5 does not possess full control over buffering. <a class="el" href="group___h5_o.html#gad99f35048cba4534b6393214684f090f" title="Flushes all buffers associated with an HDF5 object to disk.">H5Oflush()</a> flushes the internal HDF5 buffers and then asks the operating system (the OS) to flush the system buffers for the open files. After that, the OS is responsible for ensuring that the data is actually flushed to disk.</dd></dl> <dl class="section see"><dt>See also</dt><dd><a class="el" href="group___h5_d.html#ga4a2175a62baa1e35ad2467bb1fdff1f7" title="Flushes all buffers associated with a dataset to disk.">H5Dflush()</a>, <a class="el" href="group___h5_d.html#ga3c1ea7e5db3f62d9cf03dd62d1fb08da" title="Refreshes all buffers associated with a dataset.">H5Drefresh()</a>, <a class="el" href="group___h5_o.html#gad99f35048cba4534b6393214684f090f" title="Flushes all buffers associated with an HDF5 object to disk.">H5Oflush()</a>, <a class="el" href="group___h5_g.html#ga0a8bdd0eb1b001222c27d3d39a909840" title="Refreshes all buffers associated with a group.">H5Grefresh()</a>, <a class="el" href="group___h5_o.html#gad99f35048cba4534b6393214684f090f" title="Flushes all buffers associated with an HDF5 object to disk.">H5Oflush()</a>, <a class="el" href="group___h5_o.html#gaf0318b68be9ab23a92b8a6bee0af9e2f" title="Refreshes all buffers associated with an HDF5 object.">H5Orefresh()</a>, <a class="el" href="group___h5_t.html#gafd60389b49e1e5e6f37caffbe6cbf6e5" title="Flushes all buffers associated with a committed datatype to disk.">H5Tflush()</a>, <a class="el" href="group___h5_t.html#ga5bc56f6b85e114829dc12d6b18d66f4d" title="Refreshes all buffers associated with a committed datatype.">H5Trefresh()</a> </dd> <dd> -<a class="el" href="group___h5_d_o.html#ga316caac160af15192e0c78228667341e" title="Appends data to a dataset along a specified dimension.">H5DOappend()</a>, <a class="el" href="group___s_w_m_r.html#ga159be34fbe7e4a959589310ef0196dfe" title="Retrieves free-space section information for a file.">H5Fstart_swmr_write()</a>, <a class="el" href="group___d_a_p_l.html#gacd6803640eebd20e408c330192b09fa6" title="Retrieves the values of the append property that is set up in the dataset access property list.">H5Pget_append_flush()</a>, <a class="el" href="group___f_a_p_l.html#gadb66d434fd8d2f600213b0eec539564e" title="Retrieves the object flush property values from the file access property list.">H5Pget_object_flush_cb()</a>, <a class="el" href="group___d_a_p_l.html#ga2f685a7b3f3a4fa35ddcd1659ab4a835" title="Sets two actions to perform when the size of a dataset’s dimension being appended reaches a specified...">H5Pset_append_flush()</a>, <a class="el" href="group___f_a_p_l.html#gab4a4a788af5b6e88381dda0df2efbf19" title="Sets a callback function to invoke when an object flush occurs in the file.">H5Pset_object_flush_cb()</a> </dd> +<a class="el" href="group___h5_d_o.html#ga316caac160af15192e0c78228667341e" title="Appends data to a dataset along a specified dimension.">H5DOappend()</a>, <a class="el" href="group___s_w_m_r.html#ga159be34fbe7e4a959589310ef0196dfe" title="Retrieves free-space section information for a file.">H5Fstart_swmr_write()</a>, <a class="el" href="group___d_a_p_l.html#gacd6803640eebd20e408c330192b09fa6" title="Retrieves the values of the append property that is set up in the dataset access property list.">H5Pget_append_flush()</a>, <a class="el" href="group___f_a_p_l.html#gadb66d434fd8d2f600213b0eec539564e" title="Retrieves the object flush property values from the file access property list.">H5Pget_object_flush_cb()</a>, <a class="el" href="group___d_a_p_l.html#ga2f685a7b3f3a4fa35ddcd1659ab4a835" title="Sets two actions to perform when the size of a dataset's dimension being appended reaches a specified...">H5Pset_append_flush()</a>, <a class="el" href="group___f_a_p_l.html#gab4a4a788af5b6e88381dda0df2efbf19" title="Sets a callback function to invoke when an object flush occurs in the file.">H5Pset_object_flush_cb()</a> </dd> <dd> -<a class="el" href="group___h5_o.html#gab2fa388aadd1ff154ee150cbb4884c1c" title="Retrieves comment for specified object.">H5Oare_mdc_flushes_disabled()</a>, <a class="el" href="group___h5_o.html#ga0908be309da1fb4f771c1e264fac22ae" title="Prevents metadata entries for an HDF5 object from being flushed from the metadata cache to storage.">H5Odisable_mdc_flushes()</a>, <a class="el" href="group___h5_o.html#ga21014920bdabf6973e233796d7174156" title="Enables flushing of dirty metadata entries from a file’s metadata cache.">H5Oenable_mdc_flushes()</a></dd></dl> +<a class="el" href="group___h5_o.html#gab2fa388aadd1ff154ee150cbb4884c1c" title="Retrieves comment for specified object.">H5Oare_mdc_flushes_disabled()</a>, <a class="el" href="group___h5_o.html#ga0908be309da1fb4f771c1e264fac22ae" title="Prevents metadata entries for an HDF5 object from being flushed from the metadata cache to storage.">H5Odisable_mdc_flushes()</a>, <a class="el" href="group___h5_o.html#ga21014920bdabf6973e233796d7174156" title="Enables flushing of dirty metadata entries from a file's metadata cache.">H5Oenable_mdc_flushes()</a></dd></dl> <dl class="section since"><dt>Since</dt><dd>1.10.0 </dd></dl> </div> @@ -1049,7 +1049,7 @@ Note that verifying the existence of an object within an HDF5 file is a multiste <p>The target object is specified by <code>loc_id</code> and <code>name</code>. <code>loc_id</code> can specify any object in the file. <code>name</code> can be one of the following:</p> <ul> <li>The name of the object relative to <code>loc_id</code> </li> -<li>An absolute name of the object, starting from <code>/</code>, the file’s root group</li> +<li>An absolute name of the object, starting from <code>/</code>, the file's root group</li> <li>A dot (<code></code>.), if <code>loc_id</code> fully specifies the object</li> </ul> <p>The size in bytes of the comment, including the <code>NULL</code> terminator, is specified in <code>bufsize</code>. If <code>bufsize</code> is unknown, a preliminary <a class="el" href="group___h5_o.html#gae6d92d597c5a292d342a1bda91e41171" title="Retrieves comment for specified object.">H5Oget_comment_by_name()</a> call with the pointer <code>comment</code> set to <code>NULL</code> will return the size of the comment <em>without</em> the <code>NULL</code> terminator.</p> @@ -1361,7 +1361,7 @@ If the memory buildup is not desirable, you can configure a smaller cache via <a </dl> <dl class="section return"><dt>Returns</dt><dd>Returns a non-negative value if successful; otherwise, returns a negative value.</dd></dl> <dl class="deprecated"><dt><b><a class="el" href="deprecated.html#_deprecated000060">Deprecated:</a></b></dt><dd>As of HDF5-1.12 this function has been deprecated in favor of the function <a class="el" href="group___h5_o.html#gafa2f8884f7d3e7fd9b8549f5b59fd9eb" title="Retrieves the metadata for an object, identifying the object by an index position.">H5Oget_info_by_idx3()</a> or the macro <a class="el" href="group___h5_o.html#gafe764884e1530f86079288dd5895a7bd">H5Oget_info_by_idx()</a>.</dd></dl> -<p><a class="el" href="group___h5_o.html#ga7208d2cf198dcfc875603323841bffae" title="Retrieves the metadata for an object, identifying the object by an index position.">H5Oget_info_by_idx1()</a> retrieves the metadata describing an object in the <code>struct</code> <code>oinfo</code>, as specified by the location, <code>loc_id</code>, group name, <code>group_name</code>, the index by which objects in that group are tracked, <code>idx_type</code>, the order by which the index is to be traversed, <code>order</code>, and an object’s position <code>n</code> within that index.</p> +<p><a class="el" href="group___h5_o.html#ga7208d2cf198dcfc875603323841bffae" title="Retrieves the metadata for an object, identifying the object by an index position.">H5Oget_info_by_idx1()</a> retrieves the metadata describing an object in the <code>struct</code> <code>oinfo</code>, as specified by the location, <code>loc_id</code>, group name, <code>group_name</code>, the index by which objects in that group are tracked, <code>idx_type</code>, the order by which the index is to be traversed, <code>order</code>, and an object's position <code>n</code> within that index.</p> <p>If <code>loc_id</code> fully specifies the group in which the object resides, <code>group_name</code> can be a dot (<code></code>.).</p> <p>The link access property list, <code>lapl_id</code>, is not currently used; it should be passed in as <a class="el" href="_h5_ppublic_8h.html#afa85e97bfbf9bf1c58e39263846c568f">H5P_DEFAULT</a>.</p> <dl class="section version"><dt>Version</dt><dd>1.10.5 The macro <a class="el" href="group___h5_o.html#gafe764884e1530f86079288dd5895a7bd">H5Oget_info_by_idx</a> was removed and the function <a class="el" href="group___h5_o.html#gafe764884e1530f86079288dd5895a7bd">H5Oget_info_by_idx()</a> was copied to <a class="el" href="group___h5_o.html#ga7208d2cf198dcfc875603323841bffae" title="Retrieves the metadata for an object, identifying the object by an index position.">H5Oget_info_by_idx1()</a>. </dd> @@ -1452,7 +1452,7 @@ If the memory buildup is not desirable, you can configure a smaller cache via <a </dl> <dl class="section return"><dt>Returns</dt><dd>Returns a non-negative value if successful; otherwise, returns a negative value.</dd></dl> <dl class="deprecated"><dt><b><a class="el" href="deprecated.html#_deprecated000063">Deprecated:</a></b></dt><dd>As of HDF5-1.12 this function is deprecated in favor of the function <a class="el" href="group___h5_o.html#gafa2f8884f7d3e7fd9b8549f5b59fd9eb" title="Retrieves the metadata for an object, identifying the object by an index position.">H5Oget_info_by_idx3()</a> or the macro <a class="el" href="group___h5_o.html#gafe764884e1530f86079288dd5895a7bd">H5Oget_info_by_idx</a>.</dd></dl> -<p><a class="el" href="group___h5_o.html#ga85e15e65922874111da1a5efd5dd7bed" title="Retrieves the metadata for an object, identifying the object by an index position.">H5Oget_info_by_idx2()</a> retrieves the metadata describing an object in the <code>struct</code> <code>oinfo</code>, as specified by the location, <code>loc_id</code>, group name, <code>group_name</code>, the index by which objects in that group are tracked, <code>idx_type</code>, the order by which the index is to be traversed, <code>order</code>, and an object’s position <code>n</code> within that index.</p> +<p><a class="el" href="group___h5_o.html#ga85e15e65922874111da1a5efd5dd7bed" title="Retrieves the metadata for an object, identifying the object by an index position.">H5Oget_info_by_idx2()</a> retrieves the metadata describing an object in the <code>struct</code> <code>oinfo</code>, as specified by the location, <code>loc_id</code>, group name, <code>group_name</code>, the index by which objects in that group are tracked, <code>idx_type</code>, the order by which the index is to be traversed, <code>order</code>, and an object's position <code>n</code> within that index.</p> <p><code>oinfo</code>, in which the object information is returned, is a <code>struct</code> of type <a class="el" href="struct_h5_o__info1__t.html">H5O_info1_t</a>. This and other <code>struct</code> types used by <a class="el" href="group___h5_o.html#ga85e15e65922874111da1a5efd5dd7bed" title="Retrieves the metadata for an object, identifying the object by an index position.">H5Oget_info_by_idx2()</a> are described in <a class="el" href="group___h5_o.html#ga7208d2cf198dcfc875603323841bffae" title="Retrieves the metadata for an object, identifying the object by an index position.">H5Oget_info_by_idx1()</a>.</p> <p>If <code>loc_id</code> fully specifies the group in which the object resides, i<code>group_name</code> can be a dot (<code></code>.).</p> <p>The <code>fields</code> parameter contains flags to determine which fields will be filled in the <a class="el" href="struct_h5_o__info1__t.html">H5O_info1_t</a> <code>struct</code> returned in <code>oinfo</code>. These flags are defined in the <a class="el" href="_h5_opublic_8h.html">H5Opublic.h</a> file: </p><table class="doxtable"> @@ -1554,7 +1554,7 @@ If the memory buildup is not desirable, you can configure a smaller cache via <a </dd> </dl> <dl class="section return"><dt>Returns</dt><dd>Returns a non-negative value if successful; otherwise, returns a negative value.</dd></dl> -<p><a class="el" href="group___h5_o.html#gafa2f8884f7d3e7fd9b8549f5b59fd9eb" title="Retrieves the metadata for an object, identifying the object by an index position.">H5Oget_info_by_idx3()</a> retrieves the metadata describing an object in the <code>struct</code> <code>oinfo</code>, as specified by the location, <code>loc_id</code>, group name, <code>group_name</code>, the index by which objects in that group are tracked, <code>idx_type</code>, the order by which the index is to be traversed, <code>order</code>, and an object’s position <code>n</code> within that index.</p> +<p><a class="el" href="group___h5_o.html#gafa2f8884f7d3e7fd9b8549f5b59fd9eb" title="Retrieves the metadata for an object, identifying the object by an index position.">H5Oget_info_by_idx3()</a> retrieves the metadata describing an object in the <code>struct</code> <code>oinfo</code>, as specified by the location, <code>loc_id</code>, group name, <code>group_name</code>, the index by which objects in that group are tracked, <code>idx_type</code>, the order by which the index is to be traversed, <code>order</code>, and an object's position <code>n</code> within that index.</p> <p>If <code>loc_id</code> fully specifies the group in which the object resides, <code>group_name</code> can be a dot (<code></code>.).</p> <p>The <code>fields</code> parameter contains flags to determine which fields will be filled in the <a class="el" href="struct_h5_o__info2__t.html">H5O_info2_t</a> <code>struct</code> returned in <code>oinfo</code>. These flags are defined in the <a class="el" href="_h5_opublic_8h.html">H5Opublic.h</a> file: </p><table class="doxtable"> <tr> @@ -1636,7 +1636,7 @@ If the memory buildup is not desirable, you can configure a smaller cache via <a </dl> <dl class="section return"><dt>Returns</dt><dd>Returns a non-negative value if successful; otherwise, returns a negative value.</dd></dl> <dl class="deprecated"><dt><b><a class="el" href="deprecated.html#_deprecated000059">Deprecated:</a></b></dt><dd>As of HDF5-1.12 this function has been deprecated in favor of the function <a class="el" href="group___h5_o.html#ga0090da86c086c1c63a5acfaed39a035e" title="Retrieves the metadata for an object, identifying the object by location and relative name.">H5Oget_info_by_name2()</a> or the macro <a class="el" href="group___h5_o.html#ga16d8ac07f9244cfccb42b5f309ca6b3c">H5Oget_info_by_name</a>.</dd></dl> -<p><a class="el" href="group___h5_o.html#ga96ce408ffda805210844246904da2842" title="Retrieves the metadata for an object, identifying the object by location and relative name.">H5Oget_info_by_name1()</a> specifies an object’s location and name, <code>loc_id</code> and <code>name</code>, respectively, and retrieves the metadata describing that object in <code>oinfo</code>, an <a class="el" href="struct_h5_o__info1__t.html">H5O_info1_t</a> <code>struct</code>.</p> +<p><a class="el" href="group___h5_o.html#ga96ce408ffda805210844246904da2842" title="Retrieves the metadata for an object, identifying the object by location and relative name.">H5Oget_info_by_name1()</a> specifies an object's location and name, <code>loc_id</code> and <code>name</code>, respectively, and retrieves the metadata describing that object in <code>oinfo</code>, an <a class="el" href="struct_h5_o__info1__t.html">H5O_info1_t</a> <code>struct</code>.</p> <p>The <code>struct</code> <a class="el" href="struct_h5_o__info1__t.html">H5O_info1_t</a> is defined in <a class="el" href="_h5_opublic_8h.html">H5Opublic.h</a> and described in the <a class="el" href="group___h5_o.html#gaf3751684a6706e3ba49b863406011f80" title="Retrieves the metadata for an object specified by an identifier.">H5Oget_info1()</a> function entry.</p> <p>The link access property list, <code>lapl_id</code>, is not currently used; it should be passed in as <a class="el" href="_h5_ppublic_8h.html#afa85e97bfbf9bf1c58e39263846c568f">H5P_DEFAULT</a>.</p> <dl class="section version"><dt>Version</dt><dd>1.10.5 The macro <a class="el" href="group___h5_o.html#ga16d8ac07f9244cfccb42b5f309ca6b3c">H5Oget_info_by_name</a> was removed and the function <a class="el" href="group___h5_o.html#ga96ce408ffda805210844246904da2842" title="Retrieves the metadata for an object, identifying the object by location and relative name.">H5Oget_info_by_name1()</a> was copied to <a class="el" href="group___h5_o.html#ga16d8ac07f9244cfccb42b5f309ca6b3c">H5Oget_info_by_name()</a>. </dd> @@ -1706,7 +1706,7 @@ If the memory buildup is not desirable, you can configure a smaller cache via <a </dl> <dl class="section return"><dt>Returns</dt><dd>Returns a non-negative value if successful; otherwise, returns a negative value.</dd></dl> <dl class="deprecated"><dt><b><a class="el" href="deprecated.html#_deprecated000062">Deprecated:</a></b></dt><dd>As of HDF5-1.12 this function has been deprecated in favor of the function <a class="el" href="group___h5_o.html#gabb69c962999e027cef0079bbb1282199" title="Retrieves the metadata for an object, identifying the object by location and relative name.">H5Oget_info_by_name3()</a> or the macro <a class="el" href="group___h5_o.html#ga16d8ac07f9244cfccb42b5f309ca6b3c">H5Oget_info_by_name()</a>.</dd></dl> -<p><a class="el" href="group___h5_o.html#ga0090da86c086c1c63a5acfaed39a035e" title="Retrieves the metadata for an object, identifying the object by location and relative name.">H5Oget_info_by_name2()</a> specifies an object’s location and name, <code>loc_id</code> and <code>name</code>, respectively, and retrieves the metadata describing that object in <code>oinfo</code>, an <a class="el" href="struct_h5_o__info1__t.html">H5O_info1_t</a> <code>struct</code>.</p> +<p><a class="el" href="group___h5_o.html#ga0090da86c086c1c63a5acfaed39a035e" title="Retrieves the metadata for an object, identifying the object by location and relative name.">H5Oget_info_by_name2()</a> specifies an object's location and name, <code>loc_id</code> and <code>name</code>, respectively, and retrieves the metadata describing that object in <code>oinfo</code>, an <a class="el" href="struct_h5_o__info1__t.html">H5O_info1_t</a> <code>struct</code>.</p> <p>The <code>struct</code> <a class="el" href="struct_h5_o__info1__t.html">H5O_info1_t</a> is defined in <a class="el" href="_h5_opublic_8h.html">H5Opublic.h</a> and described in the <a class="el" href="group___h5_o.html#gaf3751684a6706e3ba49b863406011f80" title="Retrieves the metadata for an object specified by an identifier.">H5Oget_info1()</a> function entry.</p> <p>The <code>fields</code> parameter contains flags to determine which fields will be filled in the <a class="el" href="struct_h5_o__info1__t.html">H5O_info1_t</a> <code>struct</code> returned in <code>oinfo</code>. These flags are defined in the <a class="el" href="_h5_opublic_8h.html">H5Opublic.h</a> file:</p> <table class="doxtable"> @@ -1787,7 +1787,7 @@ If the memory buildup is not desirable, you can configure a smaller cache via <a </dd> </dl> <dl class="section return"><dt>Returns</dt><dd>Returns a non-negative value if successful; otherwise, returns a negative value.</dd></dl> -<p><a class="el" href="group___h5_o.html#gabb69c962999e027cef0079bbb1282199" title="Retrieves the metadata for an object, identifying the object by location and relative name.">H5Oget_info_by_name3()</a> specifies an object’s location and name, <code>loc_id</code> and <code>name</code>, respectively, and retrieves the metadata describing that object in <code>oinfo</code>, an <a class="el" href="struct_h5_o__info2__t.html">H5O_info2_t</a> struct.</p> +<p><a class="el" href="group___h5_o.html#gabb69c962999e027cef0079bbb1282199" title="Retrieves the metadata for an object, identifying the object by location and relative name.">H5Oget_info_by_name3()</a> specifies an object's location and name, <code>loc_id</code> and <code>name</code>, respectively, and retrieves the metadata describing that object in <code>oinfo</code>, an <a class="el" href="struct_h5_o__info2__t.html">H5O_info2_t</a> struct.</p> <p>The <code>fields</code> parameter contains flags to determine which fields will be filled in the <a class="el" href="struct_h5_o__info2__t.html">H5O_info2_t</a> <code>struct</code> returned in <code>oinfo</code>. These flags are defined in the <a class="el" href="_h5_opublic_8h.html">H5Opublic.h</a> file:</p> <table class="doxtable"> <tr> @@ -2067,8 +2067,8 @@ If the memory buildup is not desirable, you can configure a smaller cache via <a </dl> <dl class="section return"><dt>Returns</dt><dd>Returns a non-negative value if successful; otherwise, returns a negative value.</dd></dl> <p><a class="el" href="group___h5_o.html#ga2086bad6c3cd2a711c306a48c093ff55" title="Increments an object reference count.">H5Oincr_refcount()</a> increments the hard link reference count for an object. It should be used any time a user-defined link that references an object by address is added. When the link is deleted, <a class="el" href="group___h5_o.html#ga60c20da5e244c28a653d4fa23d316b44" title="Decrements an object reference count.">H5Odecr_refcount()</a> should be used.</p> -<p>An object’s reference count is the number of hard links in the file that point to that object. See the “Programming Model” section of the HDF5 Groups chapter in the – <em><a class="el" href="_u_g.html">HDF5 User Guide</a></em> for a complete discussion of reference counts.</p> -<p>If a user application needs to determine an object’s reference count, an <a class="el" href="group___h5_o.html#gaf4f302a33faba9e1c2b5f64c62ca4ed5">H5Oget_info()</a> call is required; the reference count is returned in the <code>rc</code> field of the <a class="el" href="_h5version_8h.html#a5f76b0cdd6d68d61f11e46d4f06e50d4">H5O_info_t</a> <code>struct</code>.</p> +<p>An object's reference count is the number of hard links in the file that point to that object. See the “Programming Model” section of the HDF5 Groups chapter in the – <em><a class="el" href="_u_g.html">HDF5 User Guide</a></em> for a complete discussion of reference counts.</p> +<p>If a user application needs to determine an object's reference count, an <a class="el" href="group___h5_o.html#gaf4f302a33faba9e1c2b5f64c62ca4ed5">H5Oget_info()</a> call is required; the reference count is returned in the <code>rc</code> field of the <a class="el" href="_h5version_8h.html#a5f76b0cdd6d68d61f11e46d4f06e50d4">H5O_info_t</a> <code>struct</code>.</p> <dl class="section warning"><dt>Warning</dt><dd>This function must be used with care! </dd> <dd> Improper use can lead to inaccessible data, wasted space in the file, or <b><em>file corruption</em></b>.</dd></dl> @@ -2256,9 +2256,9 @@ Improper use can lead to inaccessible data, wasted space in the file, or <b><em> <dl class="deprecated"><dt><b><a class="el" href="deprecated.html#_deprecated000057">Deprecated:</a></b></dt><dd>As of HDF5-1.12 this function has been deprecated in favor of the function <a class="el" href="group___h5_o.html#ga2ea3627cf171d0565307702a5e203262" title="Opens an object in an HDF5 file using its VOL independent token.">H5Oopen_by_token()</a>.</dd></dl> <p><a class="el" href="group___h5_o.html#ga137f3823adab4daaaf8fe87b40453fa2" title="Opens an object using its address within an HDF5 file.">H5Oopen_by_addr()</a> opens a group, dataset, or committed (named) datatype using its address within an HDF5 file, <code>addr</code>. The resulting opened object is identical to an object opened with <a class="el" href="group___h5_o.html#ga9f635f58c7ddf17f87c253bfbca08bc1" title="Opens an object in an HDF5 file by location identifier and path name.">H5Oopen()</a> and should be closed with <a class="el" href="group___h5_o.html#ga545ad7c54987013ebd50b40fe9e73c61" title="Closes an object in an HDF5 file.">H5Oclose()</a> or an object-type-specific closing function (such as <a class="el" href="group___h5_g.html#ga8dbe20b390d2504f0bd3589ed8f4e221" title="Closes the specified group.">H5Gclose()</a>) when no longer needed.</p> <p><code>loc_id</code> is a location identifier in the file.</p> -<p>The object’s address within the file, <code>addr</code>, is the byte offset of the first byte of the object header from the beginning of the HDF5 file space, i.e., from the beginning of the superblock (see the “HDF5 Storage Model” section of the The HDF5 Data Model and File Structure chapter of the <em>HDF5 User's Guide</em>.)</p> -<p><code>addr</code> can be obtained via either of two function calls. <a class="el" href="group___h5_g.html#gad75244979da933ba0b3ad25258850a6b" title="Returns information about an object.">H5Gget_objinfo()</a> returns the object’s address in the <code>objno</code> field of the <a class="el" href="struct_h5_g__stat__t.html">H5G_stat_t</a> <code>struct</code>; <a class="el" href="group___h5_l.html#ga97279697f3010a6ad31dd7f4341eb698">H5Lget_info()</a> returns the address in the <code>address</code> field of the <a class="el" href="_h5version_8h.html#af542682cfe46de7b0759e52a1608d1e4">H5L_info_t</a> <code>struct</code>.</p> -<p>The address of the HDF5 file on a physical device has no effect on <a class="el" href="group___h5_o.html#ga137f3823adab4daaaf8fe87b40453fa2" title="Opens an object using its address within an HDF5 file.">H5Oopen_by_addr()</a>, nor does the use of any file driver. As stated above, the object address is its offset within the HDF5 file; HDF5’s file drivers will transparently map this to an address on a storage device.</p> +<p>The object's address within the file, <code>addr</code>, is the byte offset of the first byte of the object header from the beginning of the HDF5 file space, i.e., from the beginning of the superblock (see the “HDF5 Storage Model” section of the The HDF5 Data Model and File Structure chapter of the <em>HDF5 User's Guide</em>.)</p> +<p><code>addr</code> can be obtained via either of two function calls. <a class="el" href="group___h5_g.html#gad75244979da933ba0b3ad25258850a6b" title="Returns information about an object.">H5Gget_objinfo()</a> returns the object's address in the <code>objno</code> field of the <a class="el" href="struct_h5_g__stat__t.html">H5G_stat_t</a> <code>struct</code>; <a class="el" href="group___h5_l.html#ga97279697f3010a6ad31dd7f4341eb698">H5Lget_info()</a> returns the address in the <code>address</code> field of the <a class="el" href="_h5version_8h.html#af542682cfe46de7b0759e52a1608d1e4">H5L_info_t</a> <code>struct</code>.</p> +<p>The address of the HDF5 file on a physical device has no effect on <a class="el" href="group___h5_o.html#ga137f3823adab4daaaf8fe87b40453fa2" title="Opens an object using its address within an HDF5 file.">H5Oopen_by_addr()</a>, nor does the use of any file driver. As stated above, the object address is its offset within the HDF5 file; HDF5's file drivers will transparently map this to an address on a storage device.</p> <dl class="section warning"><dt>Warning</dt><dd>This function must be used with care! </dd> <dd> Improper use can lead to inaccessible data, wasted space in the file, or <b><em>file corruption</em></b>. </dd> @@ -2534,7 +2534,7 @@ This function is dangerous if called on an invalid address. The risk can be safe <p>The target object is specified by <code>loc_id</code> and <code>name</code>. <code>loc_id</code> can specify any object in the file. <code>name</code> can be one of the following:</p> <ul> <li>The name of the object specified as a path relative to <code>loc_id</code> </li> -<li>An absolute name of the object, starting from <code>/</code>, the file’s root group</li> +<li>An absolute name of the object, starting from <code>/</code>, the file's root group</li> <li>A dot (<code></code>.), if <code>loc_id</code> fully specifies the object</li> </ul> <p>If <code>comment</code> is an empty string or a null pointer, any existing comment message is removed from the object.</p> @@ -2790,7 +2790,7 @@ This function is dangerous if called on an invalid address. The risk can be safe On failure, returns a negative value if something goes wrong within the library, or the first negative value returned by an operator.</dd></dl> <dl class="deprecated"><dt><b><a class="el" href="deprecated.html#_deprecated000064">Deprecated:</a></b></dt><dd>As of HDF5-1.12 this function has been deprecated in favor of the function <a class="el" href="group___h5_o.html#ga6d03115ae0e5e5b516bbf35bb492266a" title="Recursively visits all objects accessible from a specified object.">H5Ovisit3()</a> or the macro <a class="el" href="group___h5_o.html#ga5ce86255fcc34ceaf84a62551cd24233">H5Ovisit</a>.</dd></dl> <p><a class="el" href="group___h5_o.html#ga6efdb2a0a9fe9fe46695cc0f7bd993e7" title="Recursively visits all objects accessible from a specified object.">H5Ovisit1()</a> is a recursive iteration function to visit the object <code>obj_id</code> and, if <code>obj_id</code> is a group, all objects in and below it in an HDF5 file, thus providing a mechanism for an application to perform a common set of operations across all of those objects or a dynamically selected subset. For non-recursive iteration across the members of a group, see <a class="el" href="group___t_r_a_v.html#ga1e7c0a8cf17699563c02e128f27042f1" title="Iterates over links in a group, with user callback routine, according to the order within an index.">H5Literate1()</a>.</p> -<p>If <code>obj_id</code> is a group identifier, that group serves as the root of a recursive iteration. If <code>obj_id</code> is a file identifier, that file’s root group serves as the root of the recursive iteration. If <code>obj_id</code> is an attribute identifier, then the object where the attribute is attached will be iterated. If <code>obj_id</code> is any other type of object, such as a dataset or named datatype, there is no iteration.</p> +<p>If <code>obj_id</code> is a group identifier, that group serves as the root of a recursive iteration. If <code>obj_id</code> is a file identifier, that file's root group serves as the root of the recursive iteration. If <code>obj_id</code> is an attribute identifier, then the object where the attribute is attached will be iterated. If <code>obj_id</code> is any other type of object, such as a dataset or named datatype, there is no iteration.</p> <p>Two parameters are used to establish the iteration: <code>idx_type</code> and <code>order</code>.</p> <p><code>idx_type</code> specifies the index to be used. If the links in a group have not been indexed by the index type, they will first be sorted by that index then the iteration will begin; if the links have been so indexed, the sorting step will be unnecessary, so the iteration may begin more quickly.</p> <p>Note that the index type passed in <code>idx_type</code> is a <em>best effort</em> setting. If the application passes in a value indicating iteration in creation order and a group is encountered that was not tracked in creation order, that group will be iterated over in alphanumeric order by name, or <em>name order</em>. (<em>Name order</em> is the native order used by the HDF5 library and is always available.)</p> @@ -2873,7 +2873,7 @@ On failure, returns a negative value if something goes wrong within the library, On failure, returns a negative value if something goes wrong within the library, or the first negative value returned by an operator.</dd></dl> <dl class="deprecated"><dt><b><a class="el" href="deprecated.html#_deprecated000066">Deprecated:</a></b></dt><dd>As of HDF5-1.12 this function has been deprecated in favor of the function <a class="el" href="group___h5_o.html#ga6d03115ae0e5e5b516bbf35bb492266a" title="Recursively visits all objects accessible from a specified object.">H5Ovisit3()</a> or the macro <a class="el" href="group___h5_o.html#ga5ce86255fcc34ceaf84a62551cd24233">H5Ovisit</a>.</dd></dl> <p><a class="el" href="group___h5_o.html#gaa4ab542f581f4fc9a4eaa95debb29c9e" title="Recursively visits all objects accessible from a specified object.">H5Ovisit2()</a> is a recursive iteration function to visit the object <code>obj_id</code> and, if <code>obj_id</code> is a group, all objects in and below it in an HDF5 file, thus providing a mechanism for an application to perform a common set of operations across all of those objects or a dynamically selected subset. For non-recursive iteration across the members of a group, see <a class="el" href="group___t_r_a_v.html#ga1e7c0a8cf17699563c02e128f27042f1" title="Iterates over links in a group, with user callback routine, according to the order within an index.">H5Literate1()</a>.</p> -<p>If <code>obj_id</code> is a group identifier, that group serves as the root of a recursive iteration. If <code>obj_id</code> is a file identifier, that file’s root group serves as the root of the recursive iteration. If <code>obj_id</code> is an attribute identifier, then the object where the attribute is attached will be iterated. If <code>obj_id</code> is any other type of object, such as a dataset or named datatype, there is no iteration.</p> +<p>If <code>obj_id</code> is a group identifier, that group serves as the root of a recursive iteration. If <code>obj_id</code> is a file identifier, that file's root group serves as the root of the recursive iteration. If <code>obj_id</code> is an attribute identifier, then the object where the attribute is attached will be iterated. If <code>obj_id</code> is any other type of object, such as a dataset or named datatype, there is no iteration.</p> <p>Two parameters are used to establish the iteration: <code>idx_type</code> and <code>order</code>.</p> <p><code>idx_type</code> specifies the index to be used. If the links in a group have not been indexed by the index type, they will first be sorted by that index then the iteration will begin; if the links have been so indexed, the sorting step will be unnecessary, so the iteration may begin more quickly.</p> <p>Note that the index type passed in <code>idx_type</code> is a <em>best effort</em> setting. If the application passes in a value indicating iteration in creation order and a group is encountered that was not tracked in creation order, that group will be iterated over in alphanumeric order by name, or <em>name order</em>. (<em>Name order</em> is the native order used by the HDF5 library and is always available.)</p> @@ -2966,12 +2966,12 @@ On failure, returns a negative value if something goes wrong within the library, <dd> On failure, returns a negative value if something goes wrong within the library, or the first negative value returned by an operator.</dd></dl> <p><a class="el" href="group___h5_o.html#ga6d03115ae0e5e5b516bbf35bb492266a" title="Recursively visits all objects accessible from a specified object.">H5Ovisit3()</a> is a recursive iteration function to visit the object <code>obj_id</code> and, if <code>obj_id</code> is a group, all objects in and below it in an HDF5 file, thus providing a mechanism for an application to perform a common set of operations across all of those objects or a dynamically selected subset. For non-recursive iteration across the members of a group, see <a class="el" href="group___t_r_a_v.html#gad7ca4206f06b5ada85b6ec5867ec6c73" title="Iterates over links in a group, with user callback routine, according to the order within an index.">H5Literate2()</a>.</p> -<p>If <code>obj_id</code> is a group identifier, that group serves as the root of a recursive iteration. If <code>obj_id</code> is a file identifier, that file’s root group serves as the root of the recursive iteration. If <code>obj_id</code> is an attribute identifier, then the object where the attribute is attached will be iterated. If <code>obj_id</code> is any other type of object, such as a dataset or named datatype, there is no iteration.</p> +<p>If <code>obj_id</code> is a group identifier, that group serves as the root of a recursive iteration. If <code>obj_id</code> is a file identifier, that file's root group serves as the root of the recursive iteration. If <code>obj_id</code> is an attribute identifier, then the object where the attribute is attached will be iterated. If <code>obj_id</code> is any other type of object, such as a dataset or named datatype, there is no iteration.</p> <p>Two parameters are used to establish the iteration: <code>idx_type</code> and <code>order</code>.</p> <p><code>idx_type</code> specifies the index to be used. If the links in a group have not been indexed by the index type, they will first be sorted by that index then the iteration will begin; if the links have been so indexed, the sorting step will be unnecessary, so the iteration may begin more quickly.</p> <p>Note that the index type passed in <code>idx_type</code> is a <em>best effort</em> setting. If the application passes in a value indicating iteration in creation order and a group is encountered that was not tracked in creation order, that group will be iterated over in alphanumeric order by name, or <em>name order</em>. (<em>Name order</em> is the native order used by the HDF5 library and is always available.)</p> <p><code>order</code> specifies the order in which objects are to be inspected along the index specified in <code>idx_type</code>.</p> -<p>The <a class="el" href="group___h5_o.html#ga6d03115ae0e5e5b516bbf35bb492266a" title="Recursively visits all objects accessible from a specified object.">H5Ovisit3()</a> <code>op_data</code> parameter is a user-defined pointer to the data required to process objects in the course of the iteration. This pointer is passed back to each step of the iteration in the callback function’s <code>op_data</code> parameter.</p> +<p>The <a class="el" href="group___h5_o.html#ga6d03115ae0e5e5b516bbf35bb492266a" title="Recursively visits all objects accessible from a specified object.">H5Ovisit3()</a> <code>op_data</code> parameter is a user-defined pointer to the data required to process objects in the course of the iteration. This pointer is passed back to each step of the iteration in the callback function's <code>op_data</code> parameter.</p> <p>The <code>fields</code> parameter contains flags to determine which fields will be retrieved by the <code>op</code> callback function. These flags are defined in the <a class="el" href="_h5_opublic_8h.html">H5Opublic.h</a> file: </p><table class="doxtable"> <tr> <th>Flag</th><th>Purpose</th></tr> @@ -3077,14 +3077,14 @@ On failure, returns a negative value if something goes wrong within the library, On failure, returns a negative value if something goes wrong within the library, or the first negative value returned by an operator.</dd></dl> <dl class="deprecated"><dt><b><a class="el" href="deprecated.html#_deprecated000065">Deprecated:</a></b></dt><dd>As of HDF5-1.12 this function has been deprecated in favor of the function <a class="el" href="group___h5_o.html#ga34815400b01df59c4dac19436124885a" title="Recursively visits all objects accessible from a specified object.">H5Ovisit_by_name3()</a> or the macro <a class="el" href="group___h5_o.html#gab02a69e88b11404e7fd61f55344b186c">H5Ovisit_by_name</a>.</dd></dl> <p><a class="el" href="group___h5_o.html#gaffacf3bd66f4fe074099eae1c80914f2" title="Recursively visits all objects starting from a specified object.">H5Ovisit_by_name1()</a> is a recursive iteration function to visit the object specified by the <code>loc_id</code> / <code>obj_name</code> parameter pair and, if that object is a group, all objects in and below it in an HDF5 file, thus providing a mechanism for an application to perform a common set of operations across all of those objects or a dynamically selected subset. For non-recursive iteration across the members of a group, see <a class="el" href="group___t_r_a_v.html#ga1e7c0a8cf17699563c02e128f27042f1" title="Iterates over links in a group, with user callback routine, according to the order within an index.">H5Literate1()</a>.</p> -<p>The object serving as the root of the iteration is specified by the <code>loc_id</code> / <code>obj_name</code> parameter pair. <code>loc_id</code> specifies a file or an object in a file; if <code>loc_id</code> is an attribute identifier, the object where the attribute is attached will be used. <code>obj_name</code> specifies either an object in the file (with an absolute name based on the file’s root group) or an object name relative to <code>loc_id</code>. If <code>loc_id</code> fully specifies the object that is to serve as the root of the iteration, <code>obj_name</code> should be '<code></code>.' (a dot). (Note that when <code>loc_id</code> fully specifies the object that is to serve as the root of the iteration, the user may wish to consider using <a class="el" href="group___h5_o.html#ga6efdb2a0a9fe9fe46695cc0f7bd993e7" title="Recursively visits all objects accessible from a specified object.">H5Ovisit1()</a> instead of <a class="el" href="group___h5_o.html#gaffacf3bd66f4fe074099eae1c80914f2" title="Recursively visits all objects starting from a specified object.">H5Ovisit_by_name1()</a>.)</p> +<p>The object serving as the root of the iteration is specified by the <code>loc_id</code> / <code>obj_name</code> parameter pair. <code>loc_id</code> specifies a file or an object in a file; if <code>loc_id</code> is an attribute identifier, the object where the attribute is attached will be used. <code>obj_name</code> specifies either an object in the file (with an absolute name based on the file's root group) or an object name relative to <code>loc_id</code>. If <code>loc_id</code> fully specifies the object that is to serve as the root of the iteration, <code>obj_name</code> should be '<code></code>.' (a dot). (Note that when <code>loc_id</code> fully specifies the object that is to serve as the root of the iteration, the user may wish to consider using <a class="el" href="group___h5_o.html#ga6efdb2a0a9fe9fe46695cc0f7bd993e7" title="Recursively visits all objects accessible from a specified object.">H5Ovisit1()</a> instead of <a class="el" href="group___h5_o.html#gaffacf3bd66f4fe074099eae1c80914f2" title="Recursively visits all objects starting from a specified object.">H5Ovisit_by_name1()</a>.)</p> <p>Two parameters are used to establish the iteration: <code>idx_type</code> and <code>order</code>.</p> <p><code>idx_type</code> specifies the index to be used. If the links in a group have not been indexed by the index type, they will first be sorted by that index then the iteration will begin; if the links have been so indexed, the sorting step will be unnecessary, so the iteration may begin more quickly.</p> <p>Note that the index type passed in <code>idx_type</code> is a <em>best effort</em> setting. If the application passes in a value indicating iteration in creation order and a group is encountered that was not tracked in creation order, that group will be iterated over in alphanumeric order by name, or <em>name order</em>. (<em>Name order</em> is the native order used by the HDF5 library and is always available.)</p> <p><code>order</code> specifies the order in which objects are to be inspected along the index specified in <code>idx_type</code>.</p> -<p>The <code>op</code> callback function and the effect of the callback function’s return value on the application are described in <a class="el" href="group___h5_o.html#ga6efdb2a0a9fe9fe46695cc0f7bd993e7" title="Recursively visits all objects accessible from a specified object.">H5Ovisit1()</a>.</p> +<p>The <code>op</code> callback function and the effect of the callback function's return value on the application are described in <a class="el" href="group___h5_o.html#ga6efdb2a0a9fe9fe46695cc0f7bd993e7" title="Recursively visits all objects accessible from a specified object.">H5Ovisit1()</a>.</p> <p>The <a class="el" href="struct_h5_o__info1__t.html">H5O_info1_t</a> <code>struct</code> is defined in <a class="el" href="_h5_opublic_8h.html">H5Opublic.h</a> and described in the <a class="el" href="group___h5_o.html#gaf3751684a6706e3ba49b863406011f80" title="Retrieves the metadata for an object specified by an identifier.">H5Oget_info1()</a> function entry.</p> -<p>The <a class="el" href="group___h5_o.html#gaffacf3bd66f4fe074099eae1c80914f2" title="Recursively visits all objects starting from a specified object.">H5Ovisit_by_name1()</a> <code>op_data</code> parameter is a user-defined pointer to the data required to process objects in the course of the iteration. This pointer is passed back to each step of the iteration in the callback function’s <code>op_data</code> parameter.</p> +<p>The <a class="el" href="group___h5_o.html#gaffacf3bd66f4fe074099eae1c80914f2" title="Recursively visits all objects starting from a specified object.">H5Ovisit_by_name1()</a> <code>op_data</code> parameter is a user-defined pointer to the data required to process objects in the course of the iteration. This pointer is passed back to each step of the iteration in the callback function's <code>op_data</code> parameter.</p> <p><code>lapl_id</code> is a link access property list. In the general case, when default link access properties are acceptable, this can be passed in as <a class="el" href="_h5_ppublic_8h.html#afa85e97bfbf9bf1c58e39263846c568f">H5P_DEFAULT</a>. An example of a situation that requires a non-default link access property list is when the link is an external link; an external link may require that a link prefix be set in a link access property list (see <a class="el" href="group___l_a_p_l.html#gafa5eced13ba3a00cdd65669626dc7294" title="Sets prefix to be applied to external link paths.">H5Pset_elink_prefix()</a>).</p> <p><a class="el" href="group___t_r_a_v.html#ga1f1ba1bb4d44f2c111990024809417ac" title="Recursively visits all links starting from a specified group.">H5Lvisit_by_name1()</a> and <a class="el" href="group___h5_o.html#gaffacf3bd66f4fe074099eae1c80914f2" title="Recursively visits all objects starting from a specified object.">H5Ovisit_by_name1()</a> are companion functions: one for examining and operating on links; the other for examining and operating on the objects that those links point to. Both functions ensure that by the time the function completes successfully, every link or object below the specified point in the file has been presented to the application for whatever processing the application requires.</p> <dl class="section version"><dt>Version</dt><dd>1.10.5 The macro <a class="el" href="group___h5_o.html#gab02a69e88b11404e7fd61f55344b186c">H5Ovisit_by_name</a> was removed and the function <a class="el" href="group___h5_o.html#gaffacf3bd66f4fe074099eae1c80914f2" title="Recursively visits all objects starting from a specified object.">H5Ovisit_by_name1()</a> was copied to <a class="el" href="group___h5_o.html#gab02a69e88b11404e7fd61f55344b186c">H5Ovisit_by_name</a>. </dd> @@ -3178,14 +3178,14 @@ On failure, returns a negative value if something goes wrong within the library, On failure, returns a negative value if something goes wrong within the library, or the first negative value returned by an operator.</dd></dl> <dl class="deprecated"><dt><b><a class="el" href="deprecated.html#_deprecated000067">Deprecated:</a></b></dt><dd>As of HDF5-1.12 this function has been deprecated in favor of the function <a class="el" href="group___h5_o.html#ga34815400b01df59c4dac19436124885a" title="Recursively visits all objects accessible from a specified object.">H5Ovisit_by_name3()</a> or the macro <a class="el" href="group___h5_o.html#gab02a69e88b11404e7fd61f55344b186c">H5Ovisit_by_name</a>.</dd></dl> <p><a class="el" href="group___h5_o.html#ga9c155caf5499405fe403e1eb27b5beb6" title="Recursively visits all objects starting from a specified object.">H5Ovisit_by_name2()</a> is a recursive iteration function to visit the object specified by the <code>loc_id</code> / <code>obj_name</code> parameter pair and, if that object is a group, all objects in and below it in an HDF5 file, thus providing a mechanism for an application to perform a common set of operations across all of those objects or a dynamically selected subset. For non-recursive iteration across the members of a group, see <a class="el" href="group___t_r_a_v.html#ga55406698106930db68242987c11ba051">H5Literate</a>.</p> -<p>The object serving as the root of the iteration is specified by the <code>loc_id</code> / <code>obj_name</code> parameter pair. <code>loc_id</code> specifies a file or an object in a file; if <code>loc_id</code> is an attribute identifier, the object where the attribute is attached will be used. <code>obj_name</code> specifies either an object in the file (with an absolute name based in the file’s root group) or an object name relative to <code>loc_id</code>. If <code>loc_id</code> fully specifies the object that is to serve as the root of the iteration, <code>obj_name</code> should be '<code></code>.' (a dot). (Note that when <code>loc_id</code> fully specifies the object that is to serve as the root of the iteration, the user may wish to consider using <a class="el" href="group___h5_o.html#gaa4ab542f581f4fc9a4eaa95debb29c9e" title="Recursively visits all objects accessible from a specified object.">H5Ovisit2()</a> instead of <a class="el" href="group___h5_o.html#gab02a69e88b11404e7fd61f55344b186c">H5Ovisit_by_name</a>.)</p> +<p>The object serving as the root of the iteration is specified by the <code>loc_id</code> / <code>obj_name</code> parameter pair. <code>loc_id</code> specifies a file or an object in a file; if <code>loc_id</code> is an attribute identifier, the object where the attribute is attached will be used. <code>obj_name</code> specifies either an object in the file (with an absolute name based in the file's root group) or an object name relative to <code>loc_id</code>. If <code>loc_id</code> fully specifies the object that is to serve as the root of the iteration, <code>obj_name</code> should be '<code></code>.' (a dot). (Note that when <code>loc_id</code> fully specifies the object that is to serve as the root of the iteration, the user may wish to consider using <a class="el" href="group___h5_o.html#gaa4ab542f581f4fc9a4eaa95debb29c9e" title="Recursively visits all objects accessible from a specified object.">H5Ovisit2()</a> instead of <a class="el" href="group___h5_o.html#gab02a69e88b11404e7fd61f55344b186c">H5Ovisit_by_name</a>.)</p> <p>Two parameters are used to establish the iteration: <code>idx_type</code> and <code>order</code>.</p> <p><code>idx_type</code> specifies the index to be used. If the links in a group have not been indexed by the index type, they will first be sorted by that index then the iteration will begin; if the links have been so indexed, the sorting step will be unnecessary, so the iteration may begin more quickly.</p> <p>Note that the index type passed in <code>idx_type</code> is a <em>best effort</em> setting. If the application passes in a value indicating iteration in creation order and a group is encountered that was not tracked in creation order, that group will be iterated over in alphanumeric order by name, or <em>name order</em>. (<em>Name order</em> is the native order used by the HDF5 library and is always available.)</p> <p><code>order</code> specifies the order in which objects are to be inspected along the index specified in <code>idx_type</code>.</p> -<p>The <code>op</code> callback function and the effect of the callback function’s return value on the application are described in <a class="el" href="group___h5_o.html#gaa4ab542f581f4fc9a4eaa95debb29c9e" title="Recursively visits all objects accessible from a specified object.">H5Ovisit2()</a>.</p> +<p>The <code>op</code> callback function and the effect of the callback function's return value on the application are described in <a class="el" href="group___h5_o.html#gaa4ab542f581f4fc9a4eaa95debb29c9e" title="Recursively visits all objects accessible from a specified object.">H5Ovisit2()</a>.</p> <p>The <a class="el" href="struct_h5_o__info1__t.html">H5O_info1_t</a> <code>struct</code> is defined in <a class="el" href="_h5_opublic_8h.html">H5Opublic.h</a> and described in the <a class="el" href="group___h5_o.html#gaf3751684a6706e3ba49b863406011f80" title="Retrieves the metadata for an object specified by an identifier.">H5Oget_info1()</a> function entry.</p> -<p>The <a class="el" href="group___h5_o.html#ga9c155caf5499405fe403e1eb27b5beb6" title="Recursively visits all objects starting from a specified object.">H5Ovisit_by_name2()</a> <code>op_data</code> parameter is a user-defined pointer to the data required to process objects in the course of the iteration. This pointer is passed back to each step of the iteration in the callback function’s <code>op_data</code> parameter.</p> +<p>The <a class="el" href="group___h5_o.html#ga9c155caf5499405fe403e1eb27b5beb6" title="Recursively visits all objects starting from a specified object.">H5Ovisit_by_name2()</a> <code>op_data</code> parameter is a user-defined pointer to the data required to process objects in the course of the iteration. This pointer is passed back to each step of the iteration in the callback function's <code>op_data</code> parameter.</p> <p><code>lapl_id</code> is a link access property list. In the general case, when default link access properties are acceptable, this can be passed in as <a class="el" href="_h5_ppublic_8h.html#afa85e97bfbf9bf1c58e39263846c568f">H5P_DEFAULT</a>. An example of a situation that requires a non-default link access property list is when the link is an external link; an external link may require that a link prefix be set in a link access property list (see <a class="el" href="group___l_a_p_l.html#gafa5eced13ba3a00cdd65669626dc7294" title="Sets prefix to be applied to external link paths.">H5Pset_elink_prefix()</a>).</p> <p>The <code>fields</code> parameter contains flags to determine which fields will be retrieved by the <code>op</code> callback function. These flags are defined in the <a class="el" href="_h5_opublic_8h.html">H5Opublic.h</a> file: </p><table class="doxtable"> <tr> @@ -3289,12 +3289,12 @@ On failure, returns a negative value if something goes wrong within the library, <dd> On failure, returns a negative value if something goes wrong within the library, or the first negative value returned by an operator.</dd></dl> <p><a class="el" href="group___h5_o.html#ga34815400b01df59c4dac19436124885a" title="Recursively visits all objects accessible from a specified object.">H5Ovisit_by_name3()</a> is a recursive iteration function to visit the object specified by the <code>loc_id</code> / <code>obj_name</code> parameter pair and, if that object is a group, all objects in and below it in an HDF5 file, thus providing a mechanism for an application to perform a common set of operations across all of those objects or a dynamically selected subset. For non-recursive iteration across the members of a group, see <a class="el" href="group___t_r_a_v.html#gad7ca4206f06b5ada85b6ec5867ec6c73" title="Iterates over links in a group, with user callback routine, according to the order within an index.">H5Literate2()</a>.</p> -<p>The object serving as the root of the iteration is specified by the <code>loc_id</code> / <code>obj_name</code> parameter pair. <code>loc_id</code> specifies a file or an object in a file; if <code>loc_id</code> is an attribute identifier, the object where the attribute is attached will be used. <code>obj_name</code> specifies either an object in the file (with an absolute name based on the file’s root group) or an object name relative to <code>loc_id</code>. If <code>loc_id</code> fully specifies the object that is to serve as the root of the iteration, <code>obj_name</code> should be '<code></code>.' (a dot). (Note that when <code>loc_id</code> fully specifies the object that is to serve as the root of the iteration, the user may wish to consider using <a class="el" href="group___h5_o.html#ga6d03115ae0e5e5b516bbf35bb492266a" title="Recursively visits all objects accessible from a specified object.">H5Ovisit3()</a> instead of <a class="el" href="group___h5_o.html#ga34815400b01df59c4dac19436124885a" title="Recursively visits all objects accessible from a specified object.">H5Ovisit_by_name3()</a>.)</p> +<p>The object serving as the root of the iteration is specified by the <code>loc_id</code> / <code>obj_name</code> parameter pair. <code>loc_id</code> specifies a file or an object in a file; if <code>loc_id</code> is an attribute identifier, the object where the attribute is attached will be used. <code>obj_name</code> specifies either an object in the file (with an absolute name based on the file's root group) or an object name relative to <code>loc_id</code>. If <code>loc_id</code> fully specifies the object that is to serve as the root of the iteration, <code>obj_name</code> should be '<code></code>.' (a dot). (Note that when <code>loc_id</code> fully specifies the object that is to serve as the root of the iteration, the user may wish to consider using <a class="el" href="group___h5_o.html#ga6d03115ae0e5e5b516bbf35bb492266a" title="Recursively visits all objects accessible from a specified object.">H5Ovisit3()</a> instead of <a class="el" href="group___h5_o.html#ga34815400b01df59c4dac19436124885a" title="Recursively visits all objects accessible from a specified object.">H5Ovisit_by_name3()</a>.)</p> <p>Two parameters are used to establish the iteration: <code>idx_type</code> and <code>order</code>.</p> <p><code>idx_type</code> specifies the index to be used. If the links in a group have not been indexed by the index type, they will first be sorted by that index then the iteration will begin; if the links have been so indexed, the sorting step will be unnecessary, so the iteration may begin more quickly.</p> <p>Note that the index type passed in <code>idx_type</code> is a <em>best effort</em> setting. If the application passes in a value indicating iteration in creation order and a group is encountered that was not tracked in creation order, that group will be iterated over in alphanumeric order by name, or <em>name order</em>. (<em>Name order</em> is the native order used by the HDF5 library and is always available.)</p> <p><code>order</code> specifies the order in which objects are to be inspected along the index specified in <code>idx_type</code>.</p> -<p>The <a class="el" href="group___h5_o.html#ga34815400b01df59c4dac19436124885a" title="Recursively visits all objects accessible from a specified object.">H5Ovisit_by_name3()</a> <code>op_data</code> parameter is a user-defined pointer to the data required to process objects in the course of the iteration. This pointer is passed back to each step of the iteration in the callback function’s <code>op_data</code> parameter.</p> +<p>The <a class="el" href="group___h5_o.html#ga34815400b01df59c4dac19436124885a" title="Recursively visits all objects accessible from a specified object.">H5Ovisit_by_name3()</a> <code>op_data</code> parameter is a user-defined pointer to the data required to process objects in the course of the iteration. This pointer is passed back to each step of the iteration in the callback function's <code>op_data</code> parameter.</p> <p><code>lapl_id</code> is a link access property list. In the general case, when default link access properties are acceptable, this can be passed in as <a class="el" href="_h5_ppublic_8h.html#afa85e97bfbf9bf1c58e39263846c568f">H5P_DEFAULT</a>. An example of a situation that requires a non-default link access property list is when the link is an external link; an external link may require that a link prefix be set in a link access property list (see <a class="el" href="group___l_a_p_l.html#gafa5eced13ba3a00cdd65669626dc7294" title="Sets prefix to be applied to external link paths.">H5Pset_elink_prefix()</a>).</p> <p>The <code>fields</code> parameter contains flags to determine which fields will be retrieved by the <code>op</code> callback function. These flags are defined in the <a class="el" href="_h5_opublic_8h.html">H5Opublic.h</a> file: </p><table class="doxtable"> <tr> @@ -3332,7 +3332,7 @@ On failure, returns a negative value if something goes wrong within the library, <!-- start footer part --> <div id="nav-path" class="navpath"><!-- id is needed for treeview function! --> <ul> - <li class="footer">Generated on Wed Jul 19 2023 00:58:06 for HDF5 by + <li class="footer">Generated on Fri Jul 21 2023 00:33:49 for HDF5 by <a href="http://www.doxygen.org/index.html"> <img class="footer" src="doxygen.png" alt="doxygen"/></a> 1.9.1 </li> </ul> |