diff options
| author | byrnHDF <byrnHDF@users.noreply.github.com> | 2024-01-29 19:10:27 (GMT) |
|---|---|---|
| committer | byrnHDF <byrnHDF@users.noreply.github.com> | 2024-01-29 19:10:27 (GMT) |
| commit | 63b7d411312cb7c38efd1648363e347f27c24048 (patch) | |
| tree | af34e5dc2c0cdb79bc809e2034f7d8c7fed6e2e4 /develop/_h5_a__u_g.html | |
| parent | 6ba66d0a9efca6f012934bfbeb9bf4ef19465bbd (diff) | |
| download | hdf5-63b7d411312cb7c38efd1648363e347f27c24048.zip hdf5-63b7d411312cb7c38efd1648363e347f27c24048.tar.gz hdf5-63b7d411312cb7c38efd1648363e347f27c24048.tar.bz2 | |
deploy: 365e23340cd001ee751da366235ae420156ad728
Diffstat (limited to 'develop/_h5_a__u_g.html')
| -rw-r--r-- | develop/_h5_a__u_g.html | 444 |
1 files changed, 214 insertions, 230 deletions
diff --git a/develop/_h5_a__u_g.html b/develop/_h5_a__u_g.html index 68cc4d2..a3910d9 100644 --- a/develop/_h5_a__u_g.html +++ b/develop/_h5_a__u_g.html @@ -3,7 +3,7 @@ <head> <meta http-equiv="Content-Type" content="text/xhtml;charset=UTF-8"/> <meta http-equiv="X-UA-Compatible" content="IE=9"/> -<meta name="generator" content="Doxygen 1.9.1"/> +<meta name="generator" content="Doxygen 1.10.0"/> <meta name="viewport" content="width=device-width, initial-scale=1"/> <title>HDF5: HDF5 Attributes</title> <link href="tabs.css" rel="stylesheet" type="text/css"/> @@ -13,12 +13,13 @@ <script type="text/javascript" src="resize.js"></script> <script type="text/javascript" src="navtreedata.js"></script> <script type="text/javascript" src="navtree.js"></script> +<script type="text/javascript" src="cookie.js"></script> <link href="search/search.css" rel="stylesheet" type="text/css"/> <script type="text/javascript" src="search/searchdata.js"></script> <script type="text/javascript" src="search/search.js"></script> <script type="text/javascript"> -/* @license magnet:?xt=urn:btih:cf05388f2679ee054f2beb29a391d25f4e673ac3&dn=gpl-2.0.txt GPL-v2 */ - $(document).ready(function() { init_search(); }); +/* @license magnet:?xt=urn:btih:d3d9a9a6595521f9666a5e94cc830dab83b65699&dn=expat.txt MIT */ + $(function() { init_search(); }); /* @license-end */ </script> <link href="doxygen.css" rel="stylesheet" type="text/css" /> @@ -37,17 +38,14 @@ <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.5f5f5f0</span> +  <span id="projectnumber">1.15.0.365e233</span> </div> <div id="projectbrief">API Reference</div> </td> <td> <div id="MSearchBox" class="MSearchBoxInactive"> <span class="left"> - <img id="MSearchSelect" src="search/mag_sel.svg" - onmouseover="return searchBox.OnSearchSelectShow()" - onmouseout="return searchBox.OnSearchSelectHide()" - alt=""/> - <input type="text" id="MSearchField" value="Search" accesskey="S" + <span id="MSearchSelect" onmouseover="return searchBox.OnSearchSelectShow()" onmouseout="return searchBox.OnSearchSelectHide()"> </span> + <input type="text" id="MSearchField" value="" placeholder="Search" accesskey="S" onfocus="searchBox.OnSearchFieldFocus(true)" onblur="searchBox.OnSearchFieldFocus(false)" onkeyup="searchBox.OnSearchFieldChange(event)"/> @@ -61,10 +59,10 @@ </table> </div> <!-- end header part --> -<!-- Generated by Doxygen 1.9.1 --> +<!-- Generated by Doxygen 1.10.0 --> <script type="text/javascript"> -/* @license magnet:?xt=urn:btih:cf05388f2679ee054f2beb29a391d25f4e673ac3&dn=gpl-2.0.txt GPL-v2 */ -var searchBox = new SearchBox("searchBox", "search",false,'Search','.html'); +/* @license magnet:?xt=urn:btih:d3d9a9a6595521f9666a5e94cc830dab83b65699&dn=expat.txt MIT */ +var searchBox = new SearchBox("searchBox", "search/",'.html'); /* @license-end */ </script> </div><!-- top --> @@ -79,8 +77,8 @@ var searchBox = new SearchBox("searchBox", "search",false,'Search','.html'); </div> </div> <script type="text/javascript"> -/* @license magnet:?xt=urn:btih:cf05388f2679ee054f2beb29a391d25f4e673ac3&dn=gpl-2.0.txt GPL-v2 */ -$(document).ready(function(){initNavTree('_h5_a__u_g.html',''); initResizable(); }); +/* @license magnet:?xt=urn:btih:d3d9a9a6595521f9666a5e94cc830dab83b65699&dn=expat.txt MIT */ +$(function(){initNavTree('_h5_a__u_g.html',''); initResizable(); }); /* @license-end */ </script> <div id="doc-content"> @@ -93,14 +91,20 @@ $(document).ready(function(){initNavTree('_h5_a__u_g.html',''); initResizable(); <!-- iframe showing the search results (closed by default) --> <div id="MSearchResultsWindow"> -<iframe src="javascript:void(0)" frameborder="0" - name="MSearchResults" id="MSearchResults"> -</iframe> +<div id="MSearchResults"> +<div class="SRPage"> +<div id="SRIndex"> +<div id="SRResults"></div> +<div class="SRStatus" id="Loading">Loading...</div> +<div class="SRStatus" id="Searching">Searching...</div> +<div class="SRStatus" id="NoMatches">No Matches</div> +</div> +</div> +</div> </div> -<div class="PageDoc"><div class="header"> - <div class="headertitle"> -<div class="title">HDF5 Attributes </div> </div> +<div><div class="header"> + <div class="headertitle"><div class="title">HDF5 Attributes</div></div> </div><!--header--> <div class="contents"> <div class="textblock"><h1><a class="anchor" id="sec_attribute"></a> @@ -169,154 +173,129 @@ Specify the attribute creation property list</li> <tr> <th>Create</th><th>Update </th></tr> <tr valign="top"> -<td><div class="fragment"><div class="line"><a name="l00014"></a><span class="lineno"> 14</span>  {</div> -<div class="line"><a name="l00015"></a><span class="lineno"> 15</span>  __label__ fail_acpl, fail_attr, fail_file;</div> -<div class="line"><a name="l00016"></a><span class="lineno"> 16</span>  <a class="code" href="_h5_ipublic_8h.html#a0045db7ff9c22ad35db6ae91662e1943">hid_t</a> file, acpl, fspace, attr;</div> -<div class="line"><a name="l00017"></a><span class="lineno"> 17</span>  </div> -<div class="line"><a name="l00018"></a><span class="lineno"> 18</span>  <span class="keywordtype">unsigned</span> mode = <a class="code" href="_h5_fpublic_8h.html#a5a2d6726f9ad8d2bca8df2b817e5ad6a">H5F_ACC_TRUNC</a>;</div> -<div class="line"><a name="l00019"></a><span class="lineno"> 19</span>  <span class="keywordtype">char</span> file_name[] = <span class="stringliteral">"f1.h5"</span>;</div> -<div class="line"><a name="l00020"></a><span class="lineno"> 20</span>  <span class="comment">// attribute names can be arbitrary Unicode strings</span></div> -<div class="line"><a name="l00021"></a><span class="lineno"> 21</span>  <span class="keywordtype">char</span> attr_name[] = <span class="stringliteral">"Χαρακτηριστικό"</span>;</div> -<div class="line"><a name="l00022"></a><span class="lineno"> 22</span>  </div> -<div class="line"><a name="l00023"></a><span class="lineno"> 23</span>  <span class="keywordflow">if</span> ((file = <a class="code" href="group___h5_f.html#gae64b51ee9ac0781bc4ccc599d98387f4">H5Fcreate</a>(file_name, mode, <a class="code" href="_h5_ppublic_8h.html#afa85e97bfbf9bf1c58e39263846c568f">H5P_DEFAULT</a>, <a class="code" href="_h5_ppublic_8h.html#afa85e97bfbf9bf1c58e39263846c568f">H5P_DEFAULT</a>)) == <a class="code" href="_h5_ipublic_8h.html#a01eab13dccc91afd6909d74dccb780ba">H5I_INVALID_HID</a>) {</div> -<div class="line"><a name="l00024"></a><span class="lineno"> 24</span>  ret_val = EXIT_FAILURE;</div> -<div class="line"><a name="l00025"></a><span class="lineno"> 25</span>  <span class="keywordflow">goto</span> fail_file;</div> -<div class="line"><a name="l00026"></a><span class="lineno"> 26</span>  }</div> -<div class="line"><a name="l00027"></a><span class="lineno"> 27</span>  <span class="keywordflow">if</span> ((acpl = <a class="code" href="group___p_l_c_r.html#gaf1b11da01d4d45d788c45f8bc5f0cbfa">H5Pcreate</a>(<a class="code" href="_h5_ppublic_8h.html#aa0102211c679e031e2e9831b66c48a12">H5P_ATTRIBUTE_CREATE</a>)) == <a class="code" href="_h5_ipublic_8h.html#a01eab13dccc91afd6909d74dccb780ba">H5I_INVALID_HID</a>) {</div> -<div class="line"><a name="l00028"></a><span class="lineno"> 28</span>  ret_val = EXIT_FAILURE;</div> -<div class="line"><a name="l00029"></a><span class="lineno"> 29</span>  <span class="keywordflow">goto</span> fail_acpl;</div> -<div class="line"><a name="l00030"></a><span class="lineno"> 30</span>  }</div> -<div class="line"><a name="l00031"></a><span class="lineno"> 31</span>  <span class="comment">// use UTF-8 encoding for the attribute name</span></div> -<div class="line"><a name="l00032"></a><span class="lineno"> 32</span>  <span class="keywordflow">if</span> (<a class="code" href="group___a_c_p_l.html#gad4fa8e2d17236786f770cf17eef908cc">H5Pset_char_encoding</a>(acpl, <a class="code" href="_h5_tpublic_8h.html#a03755b8370672668ddc7063add28e71aa41685667f69bf81eb7de5dd5f452e658">H5T_CSET_UTF8</a>) < 0) {</div> -<div class="line"><a name="l00033"></a><span class="lineno"> 33</span>  ret_val = EXIT_FAILURE;</div> -<div class="line"><a name="l00034"></a><span class="lineno"> 34</span>  <span class="keywordflow">goto</span> fail_fspace;</div> -<div class="line"><a name="l00035"></a><span class="lineno"> 35</span>  }</div> -<div class="line"><a name="l00036"></a><span class="lineno"> 36</span>  <span class="comment">// create a scalar (singleton) attribute</span></div> -<div class="line"><a name="l00037"></a><span class="lineno"> 37</span>  <span class="keywordflow">if</span> ((fspace = <a class="code" href="group___h5_s.html#gabee514327cba34ca9951b24fa14fb083">H5Screate</a>(<a class="code" href="_h5_spublic_8h.html#ae53f3c6a52563646fbac9ead8ecdbf0aaf6a34a2439db8aa7bb63ed0c4aaa5eb8">H5S_SCALAR</a>)) == <a class="code" href="_h5_ipublic_8h.html#a01eab13dccc91afd6909d74dccb780ba">H5I_INVALID_HID</a>) {</div> -<div class="line"><a name="l00038"></a><span class="lineno"> 38</span>  ret_val = EXIT_FAILURE;</div> -<div class="line"><a name="l00039"></a><span class="lineno"> 39</span>  <span class="keywordflow">goto</span> fail_fspace;</div> -<div class="line"><a name="l00040"></a><span class="lineno"> 40</span>  }</div> -<div class="line"><a name="l00041"></a><span class="lineno"> 41</span>  <span class="comment">// create an attribute on the root group</span></div> -<div class="line"><a name="l00042"></a><span class="lineno"> 42</span>  <span class="keywordflow">if</span> ((attr = <a class="code" href="group___h5_a.html#ga4f4e5248c09f689633079ed8afc0b308">H5Acreate2</a>(file, attr_name, <a class="code" href="group___p_d_t_s_t_d.html#ga8db8c9c2bcc457f9f8526c8fcb81218b">H5T_STD_I32LE</a>, fspace, acpl, <a class="code" href="_h5_ppublic_8h.html#afa85e97bfbf9bf1c58e39263846c568f">H5P_DEFAULT</a>)) ==</div> -<div class="line"><a name="l00043"></a><span class="lineno"> 43</span>  <a class="code" href="_h5_ipublic_8h.html#a01eab13dccc91afd6909d74dccb780ba">H5I_INVALID_HID</a>) {</div> -<div class="line"><a name="l00044"></a><span class="lineno"> 44</span>  ret_val = EXIT_FAILURE;</div> -<div class="line"><a name="l00045"></a><span class="lineno"> 45</span>  <span class="keywordflow">goto</span> fail_attr;</div> -<div class="line"><a name="l00046"></a><span class="lineno"> 46</span>  }</div> -<div class="line"><a name="l00047"></a><span class="lineno"> 47</span>  </div> -<div class="line"><a name="l00048"></a><span class="lineno"> 48</span>  <a class="code" href="group___h5_a.html#gaef4394b661e2c930879e9868e122bdda">H5Aclose</a>(attr);</div> -<div class="line"><a name="l00049"></a><span class="lineno"> 49</span> fail_attr:</div> -<div class="line"><a name="l00050"></a><span class="lineno"> 50</span>  <a class="code" href="group___h5_s.html#ga2b53128a39c8f104c1c9c2a91590fcc1">H5Sclose</a>(fspace);</div> -<div class="line"><a name="l00051"></a><span class="lineno"> 51</span> fail_fspace:</div> -<div class="line"><a name="l00052"></a><span class="lineno"> 52</span>  <a class="code" href="group___p_l_c_r.html#ga5dce61149211d3ef319452aa598887fb">H5Pclose</a>(acpl);</div> -<div class="line"><a name="l00053"></a><span class="lineno"> 53</span> fail_acpl:</div> -<div class="line"><a name="l00054"></a><span class="lineno"> 54</span>  <a class="code" href="group___h5_f.html#gac55cd91d80822e4f8c2a7f04ea71b124">H5Fclose</a>(file);</div> -<div class="line"><a name="l00055"></a><span class="lineno"> 55</span> fail_file:;</div> -<div class="line"><a name="l00056"></a><span class="lineno"> 56</span>  }</div> -<div class="ttc" id="a_h5_fpublic_8h_html_a5a2d6726f9ad8d2bca8df2b817e5ad6a"><div class="ttname"><a href="_h5_fpublic_8h.html#a5a2d6726f9ad8d2bca8df2b817e5ad6a">H5F_ACC_TRUNC</a></div><div class="ttdeci">#define H5F_ACC_TRUNC</div><div class="ttdef"><b>Definition:</b> H5Fpublic.h:50</div></div> -<div class="ttc" id="a_h5_ipublic_8h_html_a0045db7ff9c22ad35db6ae91662e1943"><div class="ttname"><a href="_h5_ipublic_8h.html#a0045db7ff9c22ad35db6ae91662e1943">hid_t</a></div><div class="ttdeci">int64_t hid_t</div><div class="ttdef"><b>Definition:</b> H5Ipublic.h:60</div></div> -<div class="ttc" id="a_h5_ipublic_8h_html_a01eab13dccc91afd6909d74dccb780ba"><div class="ttname"><a href="_h5_ipublic_8h.html#a01eab13dccc91afd6909d74dccb780ba">H5I_INVALID_HID</a></div><div class="ttdeci">#define H5I_INVALID_HID</div><div class="ttdef"><b>Definition:</b> H5Ipublic.h:75</div></div> -<div class="ttc" id="a_h5_ppublic_8h_html_aa0102211c679e031e2e9831b66c48a12"><div class="ttname"><a href="_h5_ppublic_8h.html#aa0102211c679e031e2e9831b66c48a12">H5P_ATTRIBUTE_CREATE</a></div><div class="ttdeci">#define H5P_ATTRIBUTE_CREATE</div><div class="ttdef"><b>Definition:</b> H5Ppublic.h:64</div></div> -<div class="ttc" id="a_h5_ppublic_8h_html_afa85e97bfbf9bf1c58e39263846c568f"><div class="ttname"><a href="_h5_ppublic_8h.html#afa85e97bfbf9bf1c58e39263846c568f">H5P_DEFAULT</a></div><div class="ttdeci">#define H5P_DEFAULT</div><div class="ttdef"><b>Definition:</b> H5Ppublic.h:102</div></div> -<div class="ttc" id="a_h5_spublic_8h_html_ae53f3c6a52563646fbac9ead8ecdbf0aaf6a34a2439db8aa7bb63ed0c4aaa5eb8"><div class="ttname"><a href="_h5_spublic_8h.html#ae53f3c6a52563646fbac9ead8ecdbf0aaf6a34a2439db8aa7bb63ed0c4aaa5eb8">H5S_SCALAR</a></div><div class="ttdeci">@ H5S_SCALAR</div><div class="ttdef"><b>Definition:</b> H5Spublic.h:77</div></div> -<div class="ttc" id="a_h5_tpublic_8h_html_a03755b8370672668ddc7063add28e71aa41685667f69bf81eb7de5dd5f452e658"><div class="ttname"><a href="_h5_tpublic_8h.html#a03755b8370672668ddc7063add28e71aa41685667f69bf81eb7de5dd5f452e658">H5T_CSET_UTF8</a></div><div class="ttdeci">@ H5T_CSET_UTF8</div><div class="ttdef"><b>Definition:</b> H5Tpublic.h:96</div></div> -<div class="ttc" id="agroup___a_c_p_l_html_gad4fa8e2d17236786f770cf17eef908cc"><div class="ttname"><a href="group___a_c_p_l.html#gad4fa8e2d17236786f770cf17eef908cc">H5Pset_char_encoding</a></div><div class="ttdeci">herr_t H5Pset_char_encoding(hid_t plist_id, H5T_cset_t encoding)</div><div class="ttdoc">Sets the character encoding used to encode link and attribute names.</div></div> -<div class="ttc" id="agroup___h5_a_html_ga4f4e5248c09f689633079ed8afc0b308"><div class="ttname"><a href="group___h5_a.html#ga4f4e5248c09f689633079ed8afc0b308">H5Acreate2</a></div><div class="ttdeci">hid_t H5Acreate2(hid_t loc_id, const char *attr_name, hid_t type_id, hid_t space_id, hid_t acpl_id, hid_t aapl_id)</div><div class="ttdoc">Creates an attribute attached to a specified object.</div></div> -<div class="ttc" id="agroup___h5_a_html_gaef4394b661e2c930879e9868e122bdda"><div class="ttname"><a href="group___h5_a.html#gaef4394b661e2c930879e9868e122bdda">H5Aclose</a></div><div class="ttdeci">herr_t H5Aclose(hid_t attr_id)</div><div class="ttdoc">Closes the specified attribute.</div></div> -<div class="ttc" id="agroup___h5_f_html_gac55cd91d80822e4f8c2a7f04ea71b124"><div class="ttname"><a href="group___h5_f.html#gac55cd91d80822e4f8c2a7f04ea71b124">H5Fclose</a></div><div class="ttdeci">herr_t H5Fclose(hid_t file_id)</div><div class="ttdoc">Terminates access to an HDF5 file.</div></div> -<div class="ttc" id="agroup___h5_f_html_gae64b51ee9ac0781bc4ccc599d98387f4"><div class="ttname"><a href="group___h5_f.html#gae64b51ee9ac0781bc4ccc599d98387f4">H5Fcreate</a></div><div class="ttdeci">hid_t H5Fcreate(const char *filename, unsigned flags, hid_t fcpl_id, hid_t fapl_id)</div><div class="ttdoc">Creates an HDF5 file.</div></div> -<div class="ttc" id="agroup___h5_s_html_ga2b53128a39c8f104c1c9c2a91590fcc1"><div class="ttname"><a href="group___h5_s.html#ga2b53128a39c8f104c1c9c2a91590fcc1">H5Sclose</a></div><div class="ttdeci">herr_t H5Sclose(hid_t space_id)</div><div class="ttdoc">Releases and terminates access to a dataspace.</div></div> -<div class="ttc" id="agroup___h5_s_html_gabee514327cba34ca9951b24fa14fb083"><div class="ttname"><a href="group___h5_s.html#gabee514327cba34ca9951b24fa14fb083">H5Screate</a></div><div class="ttdeci">hid_t H5Screate(H5S_class_t type)</div><div class="ttdoc">Creates a new dataspace of a specified type.</div></div> -<div class="ttc" id="agroup___p_d_t_s_t_d_html_ga8db8c9c2bcc457f9f8526c8fcb81218b"><div class="ttname"><a href="group___p_d_t_s_t_d.html#ga8db8c9c2bcc457f9f8526c8fcb81218b">H5T_STD_I32LE</a></div><div class="ttdeci">#define H5T_STD_I32LE</div><div class="ttdef"><b>Definition:</b> H5Tpublic.h:310</div></div> -<div class="ttc" id="agroup___p_l_c_r_html_ga5dce61149211d3ef319452aa598887fb"><div class="ttname"><a href="group___p_l_c_r.html#ga5dce61149211d3ef319452aa598887fb">H5Pclose</a></div><div class="ttdeci">herr_t H5Pclose(hid_t plist_id)</div><div class="ttdoc">Terminates access to a property list.</div></div> -<div class="ttc" id="agroup___p_l_c_r_html_gaf1b11da01d4d45d788c45f8bc5f0cbfa"><div class="ttname"><a href="group___p_l_c_r.html#gaf1b11da01d4d45d788c45f8bc5f0cbfa">H5Pcreate</a></div><div class="ttdeci">hid_t H5Pcreate(hid_t cls_id)</div><div class="ttdoc">Creates a new property list as an instance of a property list class.</div></div> -</div><!-- fragment --> </td><td><div class="fragment"><div class="line"><a name="l00091"></a><span class="lineno"> 91</span>  {</div> -<div class="line"><a name="l00092"></a><span class="lineno"> 92</span>  __label__ fail_attr, fail_file;</div> -<div class="line"><a name="l00093"></a><span class="lineno"> 93</span>  <a class="code" href="_h5_ipublic_8h.html#a0045db7ff9c22ad35db6ae91662e1943">hid_t</a> file, attr;</div> -<div class="line"><a name="l00094"></a><span class="lineno"> 94</span>  </div> -<div class="line"><a name="l00095"></a><span class="lineno"> 95</span>  <span class="keywordtype">unsigned</span> mode = <a class="code" href="_h5_fpublic_8h.html#a402673dec5c537b27a49a9a8bd6140b4">H5F_ACC_RDWR</a>;</div> -<div class="line"><a name="l00096"></a><span class="lineno"> 96</span>  <span class="keywordtype">char</span> file_name[] = <span class="stringliteral">"f1.h5"</span>;</div> -<div class="line"><a name="l00097"></a><span class="lineno"> 97</span>  <span class="keywordtype">char</span> attr_name[] = <span class="stringliteral">"Χαρακτηριστικό"</span>;</div> -<div class="line"><a name="l00098"></a><span class="lineno"> 98</span>  <span class="keywordtype">int</span> value = 1234;</div> -<div class="line"><a name="l00099"></a><span class="lineno"> 99</span>  </div> -<div class="line"><a name="l00100"></a><span class="lineno"> 100</span>  <span class="keywordflow">if</span> ((file = <a class="code" href="group___h5_f.html#gaa3f4f877b9bb591f3880423ed2bf44bc">H5Fopen</a>(file_name, mode, <a class="code" href="_h5_ppublic_8h.html#afa85e97bfbf9bf1c58e39263846c568f">H5P_DEFAULT</a>)) == <a class="code" href="_h5_ipublic_8h.html#a01eab13dccc91afd6909d74dccb780ba">H5I_INVALID_HID</a>) {</div> -<div class="line"><a name="l00101"></a><span class="lineno"> 101</span>  ret_val = EXIT_FAILURE;</div> -<div class="line"><a name="l00102"></a><span class="lineno"> 102</span>  <span class="keywordflow">goto</span> fail_file;</div> -<div class="line"><a name="l00103"></a><span class="lineno"> 103</span>  }</div> -<div class="line"><a name="l00104"></a><span class="lineno"> 104</span>  <span class="keywordflow">if</span> ((attr = <a class="code" href="group___h5_a.html#ga59863b205b6d93b2145f0fbca49656f7">H5Aopen</a>(file, attr_name, <a class="code" href="_h5_ppublic_8h.html#afa85e97bfbf9bf1c58e39263846c568f">H5P_DEFAULT</a>)) == <a class="code" href="_h5_ipublic_8h.html#a01eab13dccc91afd6909d74dccb780ba">H5I_INVALID_HID</a>) {</div> -<div class="line"><a name="l00105"></a><span class="lineno"> 105</span>  ret_val = EXIT_FAILURE;</div> -<div class="line"><a name="l00106"></a><span class="lineno"> 106</span>  <span class="keywordflow">goto</span> fail_attr;</div> -<div class="line"><a name="l00107"></a><span class="lineno"> 107</span>  }</div> -<div class="line"><a name="l00108"></a><span class="lineno"> 108</span>  <span class="comment">// update the attribute value</span></div> -<div class="line"><a name="l00109"></a><span class="lineno"> 109</span>  <span class="keywordflow">if</span> (<a class="code" href="group___h5_a.html#gab70871e205d57450c83efd9912be2b5c">H5Awrite</a>(attr, <a class="code" href="group___p_d_t_n_a_t.html#ga3cf93ffc6782be68070ef8e00f219ec2">H5T_NATIVE_INT</a>, &value) < 0)</div> -<div class="line"><a name="l00110"></a><span class="lineno"> 110</span>  ret_val = EXIT_FAILURE;</div> -<div class="line"><a name="l00111"></a><span class="lineno"> 111</span>  </div> -<div class="line"><a name="l00112"></a><span class="lineno"> 112</span>  <a class="code" href="group___h5_a.html#gaef4394b661e2c930879e9868e122bdda">H5Aclose</a>(attr);</div> -<div class="line"><a name="l00113"></a><span class="lineno"> 113</span> fail_attr:</div> -<div class="line"><a name="l00114"></a><span class="lineno"> 114</span>  <a class="code" href="group___h5_f.html#gac55cd91d80822e4f8c2a7f04ea71b124">H5Fclose</a>(file);</div> -<div class="line"><a name="l00115"></a><span class="lineno"> 115</span> fail_file:;</div> -<div class="line"><a name="l00116"></a><span class="lineno"> 116</span>  }</div> -<div class="ttc" id="a_h5_fpublic_8h_html_a402673dec5c537b27a49a9a8bd6140b4"><div class="ttname"><a href="_h5_fpublic_8h.html#a402673dec5c537b27a49a9a8bd6140b4">H5F_ACC_RDWR</a></div><div class="ttdeci">#define H5F_ACC_RDWR</div><div class="ttdef"><b>Definition:</b> H5Fpublic.h:49</div></div> -<div class="ttc" id="agroup___h5_a_html_ga59863b205b6d93b2145f0fbca49656f7"><div class="ttname"><a href="group___h5_a.html#ga59863b205b6d93b2145f0fbca49656f7">H5Aopen</a></div><div class="ttdeci">hid_t H5Aopen(hid_t obj_id, const char *attr_name, hid_t aapl_id)</div><div class="ttdoc">Opens an attribute for an object specified by object identifier and attribute name.</div></div> -<div class="ttc" id="agroup___h5_a_html_gab70871e205d57450c83efd9912be2b5c"><div class="ttname"><a href="group___h5_a.html#gab70871e205d57450c83efd9912be2b5c">H5Awrite</a></div><div class="ttdeci">herr_t H5Awrite(hid_t attr_id, hid_t type_id, const void *buf)</div><div class="ttdoc">Writes data to an attribute.</div></div> -<div class="ttc" id="agroup___h5_f_html_gaa3f4f877b9bb591f3880423ed2bf44bc"><div class="ttname"><a href="group___h5_f.html#gaa3f4f877b9bb591f3880423ed2bf44bc">H5Fopen</a></div><div class="ttdeci">hid_t H5Fopen(const char *filename, unsigned flags, hid_t fapl_id)</div><div class="ttdoc">Opens an existing HDF5 file.</div></div> -<div class="ttc" id="agroup___p_d_t_n_a_t_html_ga3cf93ffc6782be68070ef8e00f219ec2"><div class="ttname"><a href="group___p_d_t_n_a_t.html#ga3cf93ffc6782be68070ef8e00f219ec2">H5T_NATIVE_INT</a></div><div class="ttdeci">#define H5T_NATIVE_INT</div><div class="ttdef"><b>Definition:</b> H5Tpublic.h:767</div></div> +<td><div class="fragment"><div class="line"><span class="lineno"> 14</span> {</div> +<div class="line"><span class="lineno"> 15</span> __label__ fail_acpl, fail_attr, fail_file;</div> +<div class="line"><span class="lineno"> 16</span> <a class="code hl_typedef" href="_h5_ipublic_8h.html#a0045db7ff9c22ad35db6ae91662e1943">hid_t</a> file, acpl, fspace, attr;</div> +<div class="line"><span class="lineno"> 17</span> </div> +<div class="line"><span class="lineno"> 18</span> <span class="keywordtype">unsigned</span> mode = <a class="code hl_define" href="_h5_fpublic_8h.html#a5a2d6726f9ad8d2bca8df2b817e5ad6a">H5F_ACC_TRUNC</a>;</div> +<div class="line"><span class="lineno"> 19</span> <span class="keywordtype">char</span> file_name[] = <span class="stringliteral">"f1.h5"</span>;</div> +<div class="line"><span class="lineno"> 20</span> <span class="comment">// attribute names can be arbitrary Unicode strings</span></div> +<div class="line"><span class="lineno"> 21</span> <span class="keywordtype">char</span> attr_name[] = <span class="stringliteral">"Χαρακτηριστικό"</span>;</div> +<div class="line"><span class="lineno"> 22</span> </div> +<div class="line"><span class="lineno"> 23</span> <span class="keywordflow">if</span> ((file = <a class="code hl_function" href="group___h5_f.html#gae64b51ee9ac0781bc4ccc599d98387f4">H5Fcreate</a>(file_name, mode, <a class="code hl_define" href="_h5_ppublic_8h.html#afa85e97bfbf9bf1c58e39263846c568f">H5P_DEFAULT</a>, <a class="code hl_define" href="_h5_ppublic_8h.html#afa85e97bfbf9bf1c58e39263846c568f">H5P_DEFAULT</a>)) == <a class="code hl_define" href="_h5_ipublic_8h.html#a01eab13dccc91afd6909d74dccb780ba">H5I_INVALID_HID</a>) {</div> +<div class="line"><span class="lineno"> 24</span> ret_val = EXIT_FAILURE;</div> +<div class="line"><span class="lineno"> 25</span> <span class="keywordflow">goto</span> fail_file;</div> +<div class="line"><span class="lineno"> 26</span> }</div> +<div class="line"><span class="lineno"> 27</span> <span class="keywordflow">if</span> ((acpl = <a class="code hl_function" href="group___p_l_c_r.html#gaf1b11da01d4d45d788c45f8bc5f0cbfa">H5Pcreate</a>(<a class="code hl_define" href="_h5_ppublic_8h.html#aa0102211c679e031e2e9831b66c48a12">H5P_ATTRIBUTE_CREATE</a>)) == <a class="code hl_define" href="_h5_ipublic_8h.html#a01eab13dccc91afd6909d74dccb780ba">H5I_INVALID_HID</a>) {</div> +<div class="line"><span class="lineno"> 28</span> ret_val = EXIT_FAILURE;</div> +<div class="line"><span class="lineno"> 29</span> <span class="keywordflow">goto</span> fail_acpl;</div> +<div class="line"><span class="lineno"> 30</span> }</div> +<div class="line"><span class="lineno"> 31</span> <span class="comment">// use UTF-8 encoding for the attribute name</span></div> +<div class="line"><span class="lineno"> 32</span> <span class="keywordflow">if</span> (<a class="code hl_function" href="group___a_c_p_l.html#gad4fa8e2d17236786f770cf17eef908cc">H5Pset_char_encoding</a>(acpl, <a class="code hl_enumvalue" href="_h5_tpublic_8h.html#a03755b8370672668ddc7063add28e71aa41685667f69bf81eb7de5dd5f452e658">H5T_CSET_UTF8</a>) < 0) {</div> +<div class="line"><span class="lineno"> 33</span> ret_val = EXIT_FAILURE;</div> +<div class="line"><span class="lineno"> 34</span> <span class="keywordflow">goto</span> fail_fspace;</div> +<div class="line"><span class="lineno"> 35</span> }</div> +<div class="line"><span class="lineno"> 36</span> <span class="comment">// create a scalar (singleton) attribute</span></div> +<div class="line"><span class="lineno"> 37</span> <span class="keywordflow">if</span> ((fspace = <a class="code hl_function" href="group___h5_s.html#gabee514327cba34ca9951b24fa14fb083">H5Screate</a>(<a class="code hl_enumvalue" href="_h5_spublic_8h.html#ae53f3c6a52563646fbac9ead8ecdbf0aaf6a34a2439db8aa7bb63ed0c4aaa5eb8">H5S_SCALAR</a>)) == <a class="code hl_define" href="_h5_ipublic_8h.html#a01eab13dccc91afd6909d74dccb780ba">H5I_INVALID_HID</a>) {</div> +<div class="line"><span class="lineno"> 38</span> ret_val = EXIT_FAILURE;</div> +<div class="line"><span class="lineno"> 39</span> <span class="keywordflow">goto</span> fail_fspace;</div> +<div class="line"><span class="lineno"> 40</span> }</div> +<div class="line"><span class="lineno"> 41</span> <span class="comment">// create an attribute on the root group</span></div> +<div class="line"><span class="lineno"> 42</span> <span class="keywordflow">if</span> ((attr = <a class="code hl_function" href="group___h5_a.html#ga4f4e5248c09f689633079ed8afc0b308">H5Acreate2</a>(file, attr_name, <a class="code hl_define" href="group___p_d_t_s_t_d.html#ga8db8c9c2bcc457f9f8526c8fcb81218b">H5T_STD_I32LE</a>, fspace, acpl, <a class="code hl_define" href="_h5_ppublic_8h.html#afa85e97bfbf9bf1c58e39263846c568f">H5P_DEFAULT</a>)) ==</div> +<div class="line"><span class="lineno"> 43</span> <a class="code hl_define" href="_h5_ipublic_8h.html#a01eab13dccc91afd6909d74dccb780ba">H5I_INVALID_HID</a>) {</div> +<div class="line"><span class="lineno"> 44</span> ret_val = EXIT_FAILURE;</div> +<div class="line"><span class="lineno"> 45</span> <span class="keywordflow">goto</span> fail_attr;</div> +<div class="line"><span class="lineno"> 46</span> }</div> +<div class="line"><span class="lineno"> 47</span> </div> +<div class="line"><span class="lineno"> 48</span> <a class="code hl_function" href="group___h5_a.html#gaef4394b661e2c930879e9868e122bdda">H5Aclose</a>(attr);</div> +<div class="line"><span class="lineno"> 49</span>fail_attr:</div> +<div class="line"><span class="lineno"> 50</span> <a class="code hl_function" href="group___h5_s.html#ga2b53128a39c8f104c1c9c2a91590fcc1">H5Sclose</a>(fspace);</div> +<div class="line"><span class="lineno"> 51</span>fail_fspace:</div> +<div class="line"><span class="lineno"> 52</span> <a class="code hl_function" href="group___p_l_c_r.html#ga5dce61149211d3ef319452aa598887fb">H5Pclose</a>(acpl);</div> +<div class="line"><span class="lineno"> 53</span>fail_acpl:</div> +<div class="line"><span class="lineno"> 54</span> <a class="code hl_function" href="group___h5_f.html#gac55cd91d80822e4f8c2a7f04ea71b124">H5Fclose</a>(file);</div> +<div class="line"><span class="lineno"> 55</span>fail_file:;</div> +<div class="line"><span class="lineno"> 56</span> }</div> +</div><!-- fragment --> </td><td><div class="fragment"><div class="line"><span class="lineno"> 91</span> {</div> +<div class="line"><span class="lineno"> 92</span> __label__ fail_attr, fail_file;</div> +<div class="line"><span class="lineno"> 93</span> <a class="code hl_typedef" href="_h5_ipublic_8h.html#a0045db7ff9c22ad35db6ae91662e1943">hid_t</a> file, attr;</div> +<div class="line"><span class="lineno"> 94</span> </div> +<div class="line"><span class="lineno"> 95</span> <span class="keywordtype">unsigned</span> mode = <a class="code hl_define" href="_h5_fpublic_8h.html#a402673dec5c537b27a49a9a8bd6140b4">H5F_ACC_RDWR</a>;</div> +<div class="line"><span class="lineno"> 96</span> <span class="keywordtype">char</span> file_name[] = <span class="stringliteral">"f1.h5"</span>;</div> +<div class="line"><span class="lineno"> 97</span> <span class="keywordtype">char</span> attr_name[] = <span class="stringliteral">"Χαρακτηριστικό"</span>;</div> +<div class="line"><span class="lineno"> 98</span> <span class="keywordtype">int</span> value = 1234;</div> +<div class="line"><span class="lineno"> 99</span> </div> +<div class="line"><span class="lineno"> 100</span> <span class="keywordflow">if</span> ((file = <a class="code hl_function" href="group___h5_f.html#gaa3f4f877b9bb591f3880423ed2bf44bc">H5Fopen</a>(file_name, mode, <a class="code hl_define" href="_h5_ppublic_8h.html#afa85e97bfbf9bf1c58e39263846c568f">H5P_DEFAULT</a>)) == <a class="code hl_define" href="_h5_ipublic_8h.html#a01eab13dccc91afd6909d74dccb780ba">H5I_INVALID_HID</a>) {</div> +<div class="line"><span class="lineno"> 101</span> ret_val = EXIT_FAILURE;</div> +<div class="line"><span class="lineno"> 102</span> <span class="keywordflow">goto</span> fail_file;</div> +<div class="line"><span class="lineno"> 103</span> }</div> +<div class="line"><span class="lineno"> 104</span> <span class="keywordflow">if</span> ((attr = <a class="code hl_function" href="group___h5_a.html#ga59863b205b6d93b2145f0fbca49656f7">H5Aopen</a>(file, attr_name, <a class="code hl_define" href="_h5_ppublic_8h.html#afa85e97bfbf9bf1c58e39263846c568f">H5P_DEFAULT</a>)) == <a class="code hl_define" href="_h5_ipublic_8h.html#a01eab13dccc91afd6909d74dccb780ba">H5I_INVALID_HID</a>) {</div> +<div class="line"><span class="lineno"> 105</span> ret_val = EXIT_FAILURE;</div> +<div class="line"><span class="lineno"> 106</span> <span class="keywordflow">goto</span> fail_attr;</div> +<div class="line"><span class="lineno"> 107</span> }</div> +<div class="line"><span class="lineno"> 108</span> <span class="comment">// update the attribute value</span></div> +<div class="line"><span class="lineno"> 109</span> <span class="keywordflow">if</span> (<a class="code hl_function" href="group___h5_a.html#gab70871e205d57450c83efd9912be2b5c">H5Awrite</a>(attr, <a class="code hl_define" href="group___p_d_t_n_a_t.html#ga3cf93ffc6782be68070ef8e00f219ec2">H5T_NATIVE_INT</a>, &value) < 0)</div> +<div class="line"><span class="lineno"> 110</span> ret_val = EXIT_FAILURE;</div> +<div class="line"><span class="lineno"> 111</span> </div> +<div class="line"><span class="lineno"> 112</span> <a class="code hl_function" href="group___h5_a.html#gaef4394b661e2c930879e9868e122bdda">H5Aclose</a>(attr);</div> +<div class="line"><span class="lineno"> 113</span>fail_attr:</div> +<div class="line"><span class="lineno"> 114</span> <a class="code hl_function" href="group___h5_f.html#gac55cd91d80822e4f8c2a7f04ea71b124">H5Fclose</a>(file);</div> +<div class="line"><span class="lineno"> 115</span>fail_file:;</div> +<div class="line"><span class="lineno"> 116</span> }</div> </div><!-- fragment --> </td></tr> <tr> <th>Read</th><th>Delete </th></tr> <tr valign="top"> -<td><div class="fragment"><div class="line"><a name="l00060"></a><span class="lineno"> 60</span>  {</div> -<div class="line"><a name="l00061"></a><span class="lineno"> 61</span>  __label__ fail_attr, fail_file;</div> -<div class="line"><a name="l00062"></a><span class="lineno"> 62</span>  <a class="code" href="_h5_ipublic_8h.html#a0045db7ff9c22ad35db6ae91662e1943">hid_t</a> file, attr;</div> -<div class="line"><a name="l00063"></a><span class="lineno"> 63</span>  </div> -<div class="line"><a name="l00064"></a><span class="lineno"> 64</span>  <span class="keywordtype">unsigned</span> mode = <a class="code" href="_h5_fpublic_8h.html#a1c406ffa89f4acf5a332144a2683d394">H5F_ACC_RDONLY</a>;</div> -<div class="line"><a name="l00065"></a><span class="lineno"> 65</span>  <span class="keywordtype">char</span> file_name[] = <span class="stringliteral">"f1.h5"</span>;</div> -<div class="line"><a name="l00066"></a><span class="lineno"> 66</span>  <span class="keywordtype">char</span> attr_name[] = <span class="stringliteral">"Χαρακτηριστικό"</span>;</div> -<div class="line"><a name="l00067"></a><span class="lineno"> 67</span>  <span class="keywordtype">int</span> value;</div> -<div class="line"><a name="l00068"></a><span class="lineno"> 68</span>  </div> -<div class="line"><a name="l00069"></a><span class="lineno"> 69</span>  <span class="keywordflow">if</span> ((file = <a class="code" href="group___h5_f.html#gaa3f4f877b9bb591f3880423ed2bf44bc">H5Fopen</a>(file_name, mode, <a class="code" href="_h5_ppublic_8h.html#afa85e97bfbf9bf1c58e39263846c568f">H5P_DEFAULT</a>)) == <a class="code" href="_h5_ipublic_8h.html#a01eab13dccc91afd6909d74dccb780ba">H5I_INVALID_HID</a>) {</div> -<div class="line"><a name="l00070"></a><span class="lineno"> 70</span>  ret_val = EXIT_FAILURE;</div> -<div class="line"><a name="l00071"></a><span class="lineno"> 71</span>  <span class="keywordflow">goto</span> fail_file;</div> -<div class="line"><a name="l00072"></a><span class="lineno"> 72</span>  }</div> -<div class="line"><a name="l00073"></a><span class="lineno"> 73</span>  <span class="keywordflow">if</span> ((attr = <a class="code" href="group___h5_a.html#ga59863b205b6d93b2145f0fbca49656f7">H5Aopen</a>(file, attr_name, <a class="code" href="_h5_ppublic_8h.html#afa85e97bfbf9bf1c58e39263846c568f">H5P_DEFAULT</a>)) == <a class="code" href="_h5_ipublic_8h.html#a01eab13dccc91afd6909d74dccb780ba">H5I_INVALID_HID</a>) {</div> -<div class="line"><a name="l00074"></a><span class="lineno"> 74</span>  ret_val = EXIT_FAILURE;</div> -<div class="line"><a name="l00075"></a><span class="lineno"> 75</span>  <span class="keywordflow">goto</span> fail_attr;</div> -<div class="line"><a name="l00076"></a><span class="lineno"> 76</span>  }</div> -<div class="line"><a name="l00077"></a><span class="lineno"> 77</span>  <span class="comment">// read the attribute value</span></div> -<div class="line"><a name="l00078"></a><span class="lineno"> 78</span>  <span class="keywordflow">if</span> (<a class="code" href="group___h5_a.html#gaacb27a997f7c98e8a833d0fd63b58f1c">H5Aread</a>(attr, <a class="code" href="group___p_d_t_n_a_t.html#ga3cf93ffc6782be68070ef8e00f219ec2">H5T_NATIVE_INT</a>, &value) < 0)</div> -<div class="line"><a name="l00079"></a><span class="lineno"> 79</span>  ret_val = EXIT_FAILURE;</div> -<div class="line"><a name="l00080"></a><span class="lineno"> 80</span>  </div> -<div class="line"><a name="l00081"></a><span class="lineno"> 81</span>  <span class="comment">// do something w/ the attribute value</span></div> -<div class="line"><a name="l00082"></a><span class="lineno"> 82</span>  </div> -<div class="line"><a name="l00083"></a><span class="lineno"> 83</span>  <a class="code" href="group___h5_a.html#gaef4394b661e2c930879e9868e122bdda">H5Aclose</a>(attr);</div> -<div class="line"><a name="l00084"></a><span class="lineno"> 84</span> fail_attr:</div> -<div class="line"><a name="l00085"></a><span class="lineno"> 85</span>  <a class="code" href="group___h5_f.html#gac55cd91d80822e4f8c2a7f04ea71b124">H5Fclose</a>(file);</div> -<div class="line"><a name="l00086"></a><span class="lineno"> 86</span> fail_file:;</div> -<div class="line"><a name="l00087"></a><span class="lineno"> 87</span>  }</div> -<div class="ttc" id="a_h5_fpublic_8h_html_a1c406ffa89f4acf5a332144a2683d394"><div class="ttname"><a href="_h5_fpublic_8h.html#a1c406ffa89f4acf5a332144a2683d394">H5F_ACC_RDONLY</a></div><div class="ttdeci">#define H5F_ACC_RDONLY</div><div class="ttdef"><b>Definition:</b> H5Fpublic.h:48</div></div> -<div class="ttc" id="agroup___h5_a_html_gaacb27a997f7c98e8a833d0fd63b58f1c"><div class="ttname"><a href="group___h5_a.html#gaacb27a997f7c98e8a833d0fd63b58f1c">H5Aread</a></div><div class="ttdeci">herr_t H5Aread(hid_t attr_id, hid_t type_id, void *buf)</div><div class="ttdoc">Reads the value of an attribute.</div></div> -</div><!-- fragment --> </td><td><div class="fragment"><div class="line"><a name="l00120"></a><span class="lineno"> 120</span>  {</div> -<div class="line"><a name="l00121"></a><span class="lineno"> 121</span>  __label__ fail_attr, fail_file;</div> -<div class="line"><a name="l00122"></a><span class="lineno"> 122</span>  <a class="code" href="_h5_ipublic_8h.html#a0045db7ff9c22ad35db6ae91662e1943">hid_t</a> file;</div> -<div class="line"><a name="l00123"></a><span class="lineno"> 123</span>  </div> -<div class="line"><a name="l00124"></a><span class="lineno"> 124</span>  <span class="keywordtype">unsigned</span> mode = <a class="code" href="_h5_fpublic_8h.html#a402673dec5c537b27a49a9a8bd6140b4">H5F_ACC_RDWR</a>;</div> -<div class="line"><a name="l00125"></a><span class="lineno"> 125</span>  <span class="keywordtype">char</span> file_name[] = <span class="stringliteral">"f1.h5"</span>;</div> -<div class="line"><a name="l00126"></a><span class="lineno"> 126</span>  <span class="keywordtype">char</span> attr_name[] = <span class="stringliteral">"Χαρακτηριστικό"</span>;</div> -<div class="line"><a name="l00127"></a><span class="lineno"> 127</span>  </div> -<div class="line"><a name="l00128"></a><span class="lineno"> 128</span>  <span class="keywordflow">if</span> ((file = <a class="code" href="group___h5_f.html#gaa3f4f877b9bb591f3880423ed2bf44bc">H5Fopen</a>(file_name, mode, <a class="code" href="_h5_ppublic_8h.html#afa85e97bfbf9bf1c58e39263846c568f">H5P_DEFAULT</a>)) == <a class="code" href="_h5_ipublic_8h.html#a01eab13dccc91afd6909d74dccb780ba">H5I_INVALID_HID</a>) {</div> -<div class="line"><a name="l00129"></a><span class="lineno"> 129</span>  ret_val = EXIT_FAILURE;</div> -<div class="line"><a name="l00130"></a><span class="lineno"> 130</span>  <span class="keywordflow">goto</span> fail_file;</div> -<div class="line"><a name="l00131"></a><span class="lineno"> 131</span>  }</div> -<div class="line"><a name="l00132"></a><span class="lineno"> 132</span>  <span class="comment">// delete the attribute</span></div> -<div class="line"><a name="l00133"></a><span class="lineno"> 133</span>  <span class="keywordflow">if</span> (<a class="code" href="group___h5_a.html#gada9fa3d6db52329f1fd55662de6ff6ba">H5Adelete</a>(file, attr_name) < 0) {</div> -<div class="line"><a name="l00134"></a><span class="lineno"> 134</span>  ret_val = EXIT_FAILURE;</div> -<div class="line"><a name="l00135"></a><span class="lineno"> 135</span>  <span class="keywordflow">goto</span> fail_attr;</div> -<div class="line"><a name="l00136"></a><span class="lineno"> 136</span>  }</div> -<div class="line"><a name="l00137"></a><span class="lineno"> 137</span>  </div> -<div class="line"><a name="l00138"></a><span class="lineno"> 138</span> fail_attr:</div> -<div class="line"><a name="l00139"></a><span class="lineno"> 139</span>  <a class="code" href="group___h5_f.html#gac55cd91d80822e4f8c2a7f04ea71b124">H5Fclose</a>(file);</div> -<div class="line"><a name="l00140"></a><span class="lineno"> 140</span> fail_file:;</div> -<div class="line"><a name="l00141"></a><span class="lineno"> 141</span>  }</div> -<div class="ttc" id="agroup___h5_a_html_gada9fa3d6db52329f1fd55662de6ff6ba"><div class="ttname"><a href="group___h5_a.html#gada9fa3d6db52329f1fd55662de6ff6ba">H5Adelete</a></div><div class="ttdeci">herr_t H5Adelete(hid_t loc_id, const char *attr_name)</div><div class="ttdoc">Deletes an attribute from a specified location.</div></div> +<td><div class="fragment"><div class="line"><span class="lineno"> 60</span> {</div> +<div class="line"><span class="lineno"> 61</span> __label__ fail_attr, fail_file;</div> +<div class="line"><span class="lineno"> 62</span> <a class="code hl_typedef" href="_h5_ipublic_8h.html#a0045db7ff9c22ad35db6ae91662e1943">hid_t</a> file, attr;</div> +<div class="line"><span class="lineno"> 63</span> </div> +<div class="line"><span class="lineno"> 64</span> <span class="keywordtype">unsigned</span> mode = <a class="code hl_define" href="_h5_fpublic_8h.html#a1c406ffa89f4acf5a332144a2683d394">H5F_ACC_RDONLY</a>;</div> +<div class="line"><span class="lineno"> 65</span> <span class="keywordtype">char</span> file_name[] = <span class="stringliteral">"f1.h5"</span>;</div> +<div class="line"><span class="lineno"> 66</span> <span class="keywordtype">char</span> attr_name[] = <span class="stringliteral">"Χαρακτηριστικό"</span>;</div> +<div class="line"><span class="lineno"> 67</span> <span class="keywordtype">int</span> value;</div> +<div class="line"><span class="lineno"> 68</span> </div> +<div class="line"><span class="lineno"> 69</span> <span class="keywordflow">if</span> ((file = <a class="code hl_function" href="group___h5_f.html#gaa3f4f877b9bb591f3880423ed2bf44bc">H5Fopen</a>(file_name, mode, <a class="code hl_define" href="_h5_ppublic_8h.html#afa85e97bfbf9bf1c58e39263846c568f">H5P_DEFAULT</a>)) == <a class="code hl_define" href="_h5_ipublic_8h.html#a01eab13dccc91afd6909d74dccb780ba">H5I_INVALID_HID</a>) {</div> +<div class="line"><span class="lineno"> 70</span> ret_val = EXIT_FAILURE;</div> +<div class="line"><span class="lineno"> 71</span> <span class="keywordflow">goto</span> fail_file;</div> +<div class="line"><span class="lineno"> 72</span> }</div> +<div class="line"><span class="lineno"> 73</span> <span class="keywordflow">if</span> ((attr = <a class="code hl_function" href="group___h5_a.html#ga59863b205b6d93b2145f0fbca49656f7">H5Aopen</a>(file, attr_name, <a class="code hl_define" href="_h5_ppublic_8h.html#afa85e97bfbf9bf1c58e39263846c568f">H5P_DEFAULT</a>)) == <a class="code hl_define" href="_h5_ipublic_8h.html#a01eab13dccc91afd6909d74dccb780ba">H5I_INVALID_HID</a>) {</div> +<div class="line"><span class="lineno"> 74</span> ret_val = EXIT_FAILURE;</div> +<div class="line"><span class="lineno"> 75</span> <span class="keywordflow">goto</span> fail_attr;</div> +<div class="line"><span class="lineno"> 76</span> }</div> +<div class="line"><span class="lineno"> 77</span> <span class="comment">// read the attribute value</span></div> +<div class="line"><span class="lineno"> 78</span> <span class="keywordflow">if</span> (<a class="code hl_function" href="group___h5_a.html#gaacb27a997f7c98e8a833d0fd63b58f1c">H5Aread</a>(attr, <a class="code hl_define" href="group___p_d_t_n_a_t.html#ga3cf93ffc6782be68070ef8e00f219ec2">H5T_NATIVE_INT</a>, &value) < 0)</div> +<div class="line"><span class="lineno"> 79</span> ret_val = EXIT_FAILURE;</div> +<div class="line"><span class="lineno"> 80</span> </div> +<div class="line"><span class="lineno"> 81</span> <span class="comment">// do something w/ the attribute value</span></div> +<div class="line"><span class="lineno"> 82</span> </div> +<div class="line"><span class="lineno"> 83</span> <a class="code hl_function" href="group___h5_a.html#gaef4394b661e2c930879e9868e122bdda">H5Aclose</a>(attr);</div> +<div class="line"><span class="lineno"> 84</span>fail_attr:</div> +<div class="line"><span class="lineno"> 85</span> <a class="code hl_function" href="group___h5_f.html#gac55cd91d80822e4f8c2a7f04ea71b124">H5Fclose</a>(file);</div> +<div class="line"><span class="lineno"> 86</span>fail_file:;</div> +<div class="line"><span class="lineno"> 87</span> }</div> +</div><!-- fragment --> </td><td><div class="fragment"><div class="line"><span class="lineno"> 120</span> {</div> +<div class="line"><span class="lineno"> 121</span> __label__ fail_attr, fail_file;</div> +<div class="line"><span class="lineno"> 122</span> <a class="code hl_typedef" href="_h5_ipublic_8h.html#a0045db7ff9c22ad35db6ae91662e1943">hid_t</a> file;</div> +<div class="line"><span class="lineno"> 123</span> </div> +<div class="line"><span class="lineno"> 124</span> <span class="keywordtype">unsigned</span> mode = <a class="code hl_define" href="_h5_fpublic_8h.html#a402673dec5c537b27a49a9a8bd6140b4">H5F_ACC_RDWR</a>;</div> +<div class="line"><span class="lineno"> 125</span> <span class="keywordtype">char</span> file_name[] = <span class="stringliteral">"f1.h5"</span>;</div> +<div class="line"><span class="lineno"> 126</span> <span class="keywordtype">char</span> attr_name[] = <span class="stringliteral">"Χαρακτηριστικό"</span>;</div> +<div class="line"><span class="lineno"> 127</span> </div> +<div class="line"><span class="lineno"> 128</span> <span class="keywordflow">if</span> ((file = <a class="code hl_function" href="group___h5_f.html#gaa3f4f877b9bb591f3880423ed2bf44bc">H5Fopen</a>(file_name, mode, <a class="code hl_define" href="_h5_ppublic_8h.html#afa85e97bfbf9bf1c58e39263846c568f">H5P_DEFAULT</a>)) == <a class="code hl_define" href="_h5_ipublic_8h.html#a01eab13dccc91afd6909d74dccb780ba">H5I_INVALID_HID</a>) {</div> +<div class="line"><span class="lineno"> 129</span> ret_val = EXIT_FAILURE;</div> +<div class="line"><span class="lineno"> 130</span> <span class="keywordflow">goto</span> fail_file;</div> +<div class="line"><span class="lineno"> 131</span> }</div> +<div class="line"><span class="lineno"> 132</span> <span class="comment">// delete the attribute</span></div> +<div class="line"><span class="lineno"> 133</span> <span class="keywordflow">if</span> (<a class="code hl_function" href="group___h5_a.html#gada9fa3d6db52329f1fd55662de6ff6ba">H5Adelete</a>(file, attr_name) < 0) {</div> +<div class="line"><span class="lineno"> 134</span> ret_val = EXIT_FAILURE;</div> +<div class="line"><span class="lineno"> 135</span> <span class="keywordflow">goto</span> fail_attr;</div> +<div class="line"><span class="lineno"> 136</span> }</div> +<div class="line"><span class="lineno"> 137</span> </div> +<div class="line"><span class="lineno"> 138</span>fail_attr:</div> +<div class="line"><span class="lineno"> 139</span> <a class="code hl_function" href="group___h5_f.html#gac55cd91d80822e4f8c2a7f04ea71b124">H5Fclose</a>(file);</div> +<div class="line"><span class="lineno"> 140</span>fail_file:;</div> +<div class="line"><span class="lineno"> 141</span> }</div> </div><!-- fragment --> </td></tr> </table> <h2><a class="anchor" id="subsec_attribute_work"></a> @@ -331,15 +310,18 @@ The Structure of an Attribute</h3> <h3><a class="anchor" id="subsubsec_attribute_work_create"></a> Creating, Writing, and Reading Attributes</h3> <p>If attributes are used in an HDF5 file, these functions will be employed: <a class="el" href="group___h5_a.html#ga4a76e4e5ab6eb0fd2aa7990d38d55f24">H5Acreate</a>, <a class="el" href="group___h5_a.html#gab70871e205d57450c83efd9912be2b5c">H5Awrite</a>, and <a class="el" href="group___h5_a.html#gaacb27a997f7c98e8a833d0fd63b58f1c">H5Aread</a>. <a class="el" href="group___h5_a.html#ga4a76e4e5ab6eb0fd2aa7990d38d55f24">H5Acreate</a> and <a class="el" href="group___h5_a.html#gab70871e205d57450c83efd9912be2b5c">H5Awrite</a> are used together to place the attribute in the file. If an attribute is to be used and is not currently in memory, <a class="el" href="group___h5_a.html#gaacb27a997f7c98e8a833d0fd63b58f1c">H5Aread</a> generally comes into play usually in concert with one each of the H5Aget_* and H5Aopen_* functions.</p> -<p>To create an attribute, call H5Acreate: </p><div class="fragment"><div class="line"><a class="code" href="_h5_ipublic_8h.html#a0045db7ff9c22ad35db6ae91662e1943">hid_t</a> <a class="code" href="group___h5_a.html#ga4a76e4e5ab6eb0fd2aa7990d38d55f24">H5Acreate</a> (<a class="code" href="_h5_ipublic_8h.html#a0045db7ff9c22ad35db6ae91662e1943">hid_t</a> loc_id, <span class="keyword">const</span> <span class="keywordtype">char</span> *name,</div> -<div class="line"> <a class="code" href="_h5_ipublic_8h.html#a0045db7ff9c22ad35db6ae91662e1943">hid_t</a> type_id, <a class="code" href="_h5_ipublic_8h.html#a0045db7ff9c22ad35db6ae91662e1943">hid_t</a> space_id, <a class="code" href="_h5_ipublic_8h.html#a0045db7ff9c22ad35db6ae91662e1943">hid_t</a> create_plist,</div> -<div class="line"> <a class="code" href="_h5_ipublic_8h.html#a0045db7ff9c22ad35db6ae91662e1943">hid_t</a> access_plist)</div> -<div class="ttc" id="agroup___h5_a_html_ga4a76e4e5ab6eb0fd2aa7990d38d55f24"><div class="ttname"><a href="group___h5_a.html#ga4a76e4e5ab6eb0fd2aa7990d38d55f24">H5Acreate</a></div><div class="ttdeci">#define H5Acreate</div><div class="ttdef"><b>Definition:</b> H5version.h:868</div></div> +<p>To create an attribute, call H5Acreate: </p><div class="fragment"><div class="line"><a class="code hl_typedef" href="_h5_ipublic_8h.html#a0045db7ff9c22ad35db6ae91662e1943">hid_t</a> <a class="code hl_define" href="group___h5_a.html#ga4a76e4e5ab6eb0fd2aa7990d38d55f24">H5Acreate</a> (<a class="code hl_typedef" href="_h5_ipublic_8h.html#a0045db7ff9c22ad35db6ae91662e1943">hid_t</a> loc_id, <span class="keyword">const</span> <span class="keywordtype">char</span> *name,</div> +<div class="line"> <a class="code hl_typedef" href="_h5_ipublic_8h.html#a0045db7ff9c22ad35db6ae91662e1943">hid_t</a> type_id, <a class="code hl_typedef" href="_h5_ipublic_8h.html#a0045db7ff9c22ad35db6ae91662e1943">hid_t</a> space_id, <a class="code hl_typedef" href="_h5_ipublic_8h.html#a0045db7ff9c22ad35db6ae91662e1943">hid_t</a> create_plist,</div> +<div class="line"> <a class="code hl_typedef" href="_h5_ipublic_8h.html#a0045db7ff9c22ad35db6ae91662e1943">hid_t</a> access_plist)</div> +<div class="ttc" id="a_h5_ipublic_8h_html_a0045db7ff9c22ad35db6ae91662e1943"><div class="ttname"><a href="_h5_ipublic_8h.html#a0045db7ff9c22ad35db6ae91662e1943">hid_t</a></div><div class="ttdeci">int64_t hid_t</div><div class="ttdef"><b>Definition</b> H5Ipublic.h:60</div></div> +<div class="ttc" id="agroup___h5_a_html_ga4a76e4e5ab6eb0fd2aa7990d38d55f24"><div class="ttname"><a href="group___h5_a.html#ga4a76e4e5ab6eb0fd2aa7990d38d55f24">H5Acreate</a></div><div class="ttdeci">#define H5Acreate</div><div class="ttdef"><b>Definition</b> H5version.h:868</div></div> </div><!-- fragment --><p> loc_id identifies the object (dataset, group, or committed datatype) to which the attribute is to be attached. name, type_id, space_id, and create_plist convey, respectively, the attribute's name, datatype, dataspace, and attribute creation property list. The attribute's name must be locally unique: it must be unique within the context of the object to which it is attached.</p> <p><a class="el" href="group___h5_a.html#ga4a76e4e5ab6eb0fd2aa7990d38d55f24">H5Acreate</a> creates the attribute in memory. The attribute does not exist in the file until <a class="el" href="group___h5_a.html#gab70871e205d57450c83efd9912be2b5c">H5Awrite</a> writes it there.</p> -<p>To write or read an attribute, call H5Awrite or H5Aread, respectively: </p><div class="fragment"><div class="line"><a class="code" href="_h5public_8h.html#a3b079ecf932a5c599499cf7e298af160">herr_t</a> <a class="code" href="group___h5_a.html#gab70871e205d57450c83efd9912be2b5c">H5Awrite</a> (<a class="code" href="_h5_ipublic_8h.html#a0045db7ff9c22ad35db6ae91662e1943">hid_t</a> attr_id, <a class="code" href="_h5_ipublic_8h.html#a0045db7ff9c22ad35db6ae91662e1943">hid_t</a> mem_type_id, <span class="keyword">const</span> <span class="keywordtype">void</span> *buf)</div> -<div class="line"><a class="code" href="_h5public_8h.html#a3b079ecf932a5c599499cf7e298af160">herr_t</a> <a class="code" href="group___h5_a.html#gaacb27a997f7c98e8a833d0fd63b58f1c">H5Aread</a> (<a class="code" href="_h5_ipublic_8h.html#a0045db7ff9c22ad35db6ae91662e1943">hid_t</a> attr_id, <a class="code" href="_h5_ipublic_8h.html#a0045db7ff9c22ad35db6ae91662e1943">hid_t</a> mem_type_id, <span class="keywordtype">void</span> *buf)</div> -<div class="ttc" id="a_h5public_8h_html_a3b079ecf932a5c599499cf7e298af160"><div class="ttname"><a href="_h5public_8h.html#a3b079ecf932a5c599499cf7e298af160">herr_t</a></div><div class="ttdeci">int herr_t</div><div class="ttdef"><b>Definition:</b> H5public.h:235</div></div> +<p>To write or read an attribute, call H5Awrite or H5Aread, respectively: </p><div class="fragment"><div class="line"><a class="code hl_typedef" href="_h5public_8h.html#a3b079ecf932a5c599499cf7e298af160">herr_t</a> <a class="code hl_function" href="group___h5_a.html#gab70871e205d57450c83efd9912be2b5c">H5Awrite</a> (<a class="code hl_typedef" href="_h5_ipublic_8h.html#a0045db7ff9c22ad35db6ae91662e1943">hid_t</a> attr_id, <a class="code hl_typedef" href="_h5_ipublic_8h.html#a0045db7ff9c22ad35db6ae91662e1943">hid_t</a> mem_type_id, <span class="keyword">const</span> <span class="keywordtype">void</span> *buf)</div> +<div class="line"><a class="code hl_typedef" href="_h5public_8h.html#a3b079ecf932a5c599499cf7e298af160">herr_t</a> <a class="code hl_function" href="group___h5_a.html#gaacb27a997f7c98e8a833d0fd63b58f1c">H5Aread</a> (<a class="code hl_typedef" href="_h5_ipublic_8h.html#a0045db7ff9c22ad35db6ae91662e1943">hid_t</a> attr_id, <a class="code hl_typedef" href="_h5_ipublic_8h.html#a0045db7ff9c22ad35db6ae91662e1943">hid_t</a> mem_type_id, <span class="keywordtype">void</span> *buf)</div> +<div class="ttc" id="a_h5public_8h_html_a3b079ecf932a5c599499cf7e298af160"><div class="ttname"><a href="_h5public_8h.html#a3b079ecf932a5c599499cf7e298af160">herr_t</a></div><div class="ttdeci">int herr_t</div><div class="ttdef"><b>Definition</b> H5public.h:235</div></div> +<div class="ttc" id="agroup___h5_a_html_gaacb27a997f7c98e8a833d0fd63b58f1c"><div class="ttname"><a href="group___h5_a.html#gaacb27a997f7c98e8a833d0fd63b58f1c">H5Aread</a></div><div class="ttdeci">herr_t H5Aread(hid_t attr_id, hid_t type_id, void *buf)</div><div class="ttdoc">Reads the value of an attribute.</div></div> +<div class="ttc" id="agroup___h5_a_html_gab70871e205d57450c83efd9912be2b5c"><div class="ttname"><a href="group___h5_a.html#gab70871e205d57450c83efd9912be2b5c">H5Awrite</a></div><div class="ttdeci">herr_t H5Awrite(hid_t attr_id, hid_t type_id, const void *buf)</div><div class="ttdoc">Writes data to an attribute.</div></div> </div><!-- fragment --><p> attr_id identifies the attribute while mem_type_id identifies the in-memory datatype of the attribute data.</p> <p><a class="el" href="group___h5_a.html#gab70871e205d57450c83efd9912be2b5c">H5Awrite</a> writes the attribute data from the buffer buf to the file. <a class="el" href="group___h5_a.html#gaacb27a997f7c98e8a833d0fd63b58f1c">H5Aread</a> reads attribute data from the file into buf.</p> <p>The HDF5 Library converts the metadata between the in-memory datatype, mem_type_id, and the in-file datatype, defined when the attribute was created, without user intervention.</p> @@ -356,30 +338,30 @@ Obtaining Information Regarding an Object's Attributes</h3> <li>The datatype of an attribute </li> <li>The number of attributes attached to an object</li> </ul> -<p>To obtain an attribute's name, call H5Aget_name with an attribute identifier, attr_id: </p><div class="fragment"><div class="line"><a class="code" href="_h5public_8h.html#af629ed855824cf5955b54529adf78ad6">ssize_t</a> <a class="code" href="group___h5_a.html#ga05e195aabab8c623b1c52009aeb99674">H5Aget_name</a> (<a class="code" href="_h5_ipublic_8h.html#a0045db7ff9c22ad35db6ae91662e1943">hid_t</a> attr_id, <span class="keywordtype">size_t</span> buf_size, <span class="keywordtype">char</span> *buf)</div> -<div class="ttc" id="a_h5public_8h_html_af629ed855824cf5955b54529adf78ad6"><div class="ttname"><a href="_h5public_8h.html#af629ed855824cf5955b54529adf78ad6">ssize_t</a></div><div class="ttdeci">int ssize_t</div><div class="ttdef"><b>Definition:</b> H5public.h:279</div></div> +<p>To obtain an attribute's name, call H5Aget_name with an attribute identifier, attr_id: </p><div class="fragment"><div class="line"><a class="code hl_typedef" href="_h5public_8h.html#af629ed855824cf5955b54529adf78ad6">ssize_t</a> <a class="code hl_function" href="group___h5_a.html#ga05e195aabab8c623b1c52009aeb99674">H5Aget_name</a> (<a class="code hl_typedef" href="_h5_ipublic_8h.html#a0045db7ff9c22ad35db6ae91662e1943">hid_t</a> attr_id, <span class="keywordtype">size_t</span> buf_size, <span class="keywordtype">char</span> *buf)</div> +<div class="ttc" id="a_h5public_8h_html_af629ed855824cf5955b54529adf78ad6"><div class="ttname"><a href="_h5public_8h.html#af629ed855824cf5955b54529adf78ad6">ssize_t</a></div><div class="ttdeci">int ssize_t</div><div class="ttdef"><b>Definition</b> H5public.h:279</div></div> <div class="ttc" id="agroup___h5_a_html_ga05e195aabab8c623b1c52009aeb99674"><div class="ttname"><a href="group___h5_a.html#ga05e195aabab8c623b1c52009aeb99674">H5Aget_name</a></div><div class="ttdeci">ssize_t H5Aget_name(hid_t attr_id, size_t buf_size, char *buf)</div><div class="ttdoc">Gets an attribute name.</div></div> </div><!-- fragment --><p> As with other attribute functions, attr_id identifies the attribute; buf_size defines the size of the buffer; and buf is the buffer to which the attribute's name will be read.</p> <p>If the length of the attribute name, and hence the value required for buf_size, is unknown, a first call to <a class="el" href="group___h5_a.html#ga05e195aabab8c623b1c52009aeb99674">H5Aget_name</a> will return that size. If the value of buf_size used in that first call is too small, the name will simply be truncated in buf. A second <a class="el" href="group___h5_a.html#ga05e195aabab8c623b1c52009aeb99674">H5Aget_name</a> call can then be used to retrieve the name in an appropriately-sized buffer.</p> -<p>To determine the dataspace or datatype of an attribute, call <a class="el" href="group___h5_a.html#ga9e21e544119d03f9342530b45a71d74d">H5Aget_space</a> or <a class="el" href="group___h5_a.html#ga0b070b714b2e535df2e1cb3005026a44">H5Aget_type</a>, respectively:</p><div class="fragment"><div class="line"><a class="code" href="_h5_ipublic_8h.html#a0045db7ff9c22ad35db6ae91662e1943">hid_t</a> <a class="code" href="group___h5_a.html#ga9e21e544119d03f9342530b45a71d74d">H5Aget_space</a> (<a class="code" href="_h5_ipublic_8h.html#a0045db7ff9c22ad35db6ae91662e1943">hid_t</a> attr_id) <a class="code" href="_h5_ipublic_8h.html#a0045db7ff9c22ad35db6ae91662e1943">hid_t</a> <a class="code" href="group___h5_a.html#ga0b070b714b2e535df2e1cb3005026a44">H5Aget_type</a> (<a class="code" href="_h5_ipublic_8h.html#a0045db7ff9c22ad35db6ae91662e1943">hid_t</a> attr_id) </div> +<p>To determine the dataspace or datatype of an attribute, call <a class="el" href="group___h5_a.html#ga9e21e544119d03f9342530b45a71d74d">H5Aget_space</a> or <a class="el" href="group___h5_a.html#ga0b070b714b2e535df2e1cb3005026a44">H5Aget_type</a>, respectively: </p><div class="fragment"><div class="line"><a class="code hl_typedef" href="_h5_ipublic_8h.html#a0045db7ff9c22ad35db6ae91662e1943">hid_t</a> <a class="code hl_function" href="group___h5_a.html#ga9e21e544119d03f9342530b45a71d74d">H5Aget_space</a> (<a class="code hl_typedef" href="_h5_ipublic_8h.html#a0045db7ff9c22ad35db6ae91662e1943">hid_t</a> attr_id) <a class="code hl_typedef" href="_h5_ipublic_8h.html#a0045db7ff9c22ad35db6ae91662e1943">hid_t</a> <a class="code hl_function" href="group___h5_a.html#ga0b070b714b2e535df2e1cb3005026a44">H5Aget_type</a> (<a class="code hl_typedef" href="_h5_ipublic_8h.html#a0045db7ff9c22ad35db6ae91662e1943">hid_t</a> attr_id) </div> <div class="ttc" id="agroup___h5_a_html_ga0b070b714b2e535df2e1cb3005026a44"><div class="ttname"><a href="group___h5_a.html#ga0b070b714b2e535df2e1cb3005026a44">H5Aget_type</a></div><div class="ttdeci">hid_t H5Aget_type(hid_t attr_id)</div><div class="ttdoc">Gets an attribute's datatype.</div></div> <div class="ttc" id="agroup___h5_a_html_ga9e21e544119d03f9342530b45a71d74d"><div class="ttname"><a href="group___h5_a.html#ga9e21e544119d03f9342530b45a71d74d">H5Aget_space</a></div><div class="ttdeci">hid_t H5Aget_space(hid_t attr_id)</div><div class="ttdoc">Gets a copy of the dataspace for an attribute.</div></div> </div><!-- fragment --><p> <a class="el" href="group___h5_a.html#ga9e21e544119d03f9342530b45a71d74d">H5Aget_space</a> returns the dataspace identifier for the attribute attr_id. <a class="el" href="group___h5_a.html#ga0b070b714b2e535df2e1cb3005026a44">H5Aget_type</a> returns the datatype identifier for the attribute attr_id.</p> -<p>To determine the number of attributes attached to an object, use the <a class="el" href="group___h5_o.html#gaf4f302a33faba9e1c2b5f64c62ca4ed5">H5Oget_info</a> function. The function signature is below.</p><div class="fragment"><div class="line"><a class="code" href="_h5public_8h.html#a3b079ecf932a5c599499cf7e298af160">herr_t</a> <a class="code" href="group___h5_o.html#gaf4f302a33faba9e1c2b5f64c62ca4ed5">H5Oget_info</a>( <a class="code" href="_h5_ipublic_8h.html#a0045db7ff9c22ad35db6ae91662e1943">hid_t</a> object_id, <a class="code" href="_h5version_8h.html#a5f76b0cdd6d68d61f11e46d4f06e50d4">H5O_info_t</a> *object_info ) </div> -<div class="ttc" id="a_h5version_8h_html_a5f76b0cdd6d68d61f11e46d4f06e50d4"><div class="ttname"><a href="_h5version_8h.html#a5f76b0cdd6d68d61f11e46d4f06e50d4">H5O_info_t</a></div><div class="ttdeci">#define H5O_info_t</div><div class="ttdef"><b>Definition:</b> H5version.h:1310</div></div> -<div class="ttc" id="agroup___h5_o_html_gaf4f302a33faba9e1c2b5f64c62ca4ed5"><div class="ttname"><a href="group___h5_o.html#gaf4f302a33faba9e1c2b5f64c62ca4ed5">H5Oget_info</a></div><div class="ttdeci">#define H5Oget_info</div><div class="ttdef"><b>Definition:</b> H5version.h:1097</div></div> +<p>To determine the number of attributes attached to an object, use the <a class="el" href="group___h5_o.html#gaf4f302a33faba9e1c2b5f64c62ca4ed5">H5Oget_info</a> function. The function signature is below. </p><div class="fragment"><div class="line"><a class="code hl_typedef" href="_h5public_8h.html#a3b079ecf932a5c599499cf7e298af160">herr_t</a> <a class="code hl_define" href="group___h5_o.html#gaf4f302a33faba9e1c2b5f64c62ca4ed5">H5Oget_info</a>( <a class="code hl_typedef" href="_h5_ipublic_8h.html#a0045db7ff9c22ad35db6ae91662e1943">hid_t</a> object_id, <a class="code hl_define" href="_h5version_8h.html#a5f76b0cdd6d68d61f11e46d4f06e50d4">H5O_info_t</a> *object_info ) </div> +<div class="ttc" id="a_h5version_8h_html_a5f76b0cdd6d68d61f11e46d4f06e50d4"><div class="ttname"><a href="_h5version_8h.html#a5f76b0cdd6d68d61f11e46d4f06e50d4">H5O_info_t</a></div><div class="ttdeci">#define H5O_info_t</div><div class="ttdef"><b>Definition</b> H5version.h:1310</div></div> +<div class="ttc" id="agroup___h5_o_html_gaf4f302a33faba9e1c2b5f64c62ca4ed5"><div class="ttname"><a href="group___h5_o.html#gaf4f302a33faba9e1c2b5f64c62ca4ed5">H5Oget_info</a></div><div class="ttdeci">#define H5Oget_info</div><div class="ttdef"><b>Definition</b> H5version.h:1097</div></div> </div><!-- fragment --><p> The number of attributes will be returned in the object_info buffer. This is generally the preferred first step in determining attribute index values. If the call returns N, the attributes attached to the object object_id have index values of 0 through N-1.</p> <h3><a class="anchor" id="subsubsec_attribute_work_iterate"></a> Iterating across an Object's Attributes</h3> <p>It is sometimes useful to be able to perform the identical operation across all of the attributes attached to an object. At the simplest level, you might just want to open each attribute. At a higher level, you might wish to perform a rather complex operation on each attribute as you iterate across the set.</p> -<p>To iterate an operation across the attributes attached to an object, one must make a series of calls to <a class="el" href="group___h5_a.html#gab9dcfc543cd4282f32b8ea19e08ffa6c">H5Aiterate</a> </p><div class="fragment"><div class="line"><a class="code" href="_h5public_8h.html#a3b079ecf932a5c599499cf7e298af160">herr_t</a> <a class="code" href="group___h5_a.html#gab9dcfc543cd4282f32b8ea19e08ffa6c">H5Aiterate</a> (<a class="code" href="_h5_ipublic_8h.html#a0045db7ff9c22ad35db6ae91662e1943">hid_t</a> obj_id, <a class="code" href="_h5public_8h.html#a8203c78e10ab2d89d8bce688a31afad3">H5_index_t</a> index_type,</div> -<div class="line"> <a class="code" href="_h5public_8h.html#a6a6ddd1504d1ed61939d46d91d9441b9">H5_iter_order_t</a> order, <a class="code" href="_h5public_8h.html#a7f81cce70fb546af88da24d9285d3c1c">hsize_t</a> *n, <a class="code" href="_h5_apublic_8h.html#a28fef0ded9a6c0eb12334c0d15dc3e74">H5A_operator2_t</a> op,</div> +<p>To iterate an operation across the attributes attached to an object, one must make a series of calls to <a class="el" href="group___h5_a.html#gab9dcfc543cd4282f32b8ea19e08ffa6c">H5Aiterate</a> </p><div class="fragment"><div class="line"><a class="code hl_typedef" href="_h5public_8h.html#a3b079ecf932a5c599499cf7e298af160">herr_t</a> <a class="code hl_define" href="group___h5_a.html#gab9dcfc543cd4282f32b8ea19e08ffa6c">H5Aiterate</a> (<a class="code hl_typedef" href="_h5_ipublic_8h.html#a0045db7ff9c22ad35db6ae91662e1943">hid_t</a> obj_id, <a class="code hl_enumeration" href="_h5public_8h.html#a8203c78e10ab2d89d8bce688a31afad3">H5_index_t</a> index_type,</div> +<div class="line"> <a class="code hl_enumeration" href="_h5public_8h.html#a6a6ddd1504d1ed61939d46d91d9441b9">H5_iter_order_t</a> order, <a class="code hl_typedef" href="_h5public_8h.html#a7f81cce70fb546af88da24d9285d3c1c">hsize_t</a> *n, <a class="code hl_typedef" href="_h5_apublic_8h.html#a28fef0ded9a6c0eb12334c0d15dc3e74">H5A_operator2_t</a> op,</div> <div class="line"> <span class="keywordtype">void</span> *op_data)</div> -<div class="ttc" id="a_h5_apublic_8h_html_a28fef0ded9a6c0eb12334c0d15dc3e74"><div class="ttname"><a href="_h5_apublic_8h.html#a28fef0ded9a6c0eb12334c0d15dc3e74">H5A_operator2_t</a></div><div class="ttdeci">herr_t(* H5A_operator2_t)(hid_t location_id, const char *attr_name, const H5A_info_t *ainfo, void *op_data)</div><div class="ttdef"><b>Definition:</b> H5Apublic.h:55</div></div> -<div class="ttc" id="a_h5public_8h_html_a6a6ddd1504d1ed61939d46d91d9441b9"><div class="ttname"><a href="_h5public_8h.html#a6a6ddd1504d1ed61939d46d91d9441b9">H5_iter_order_t</a></div><div class="ttdeci">H5_iter_order_t</div><div class="ttdef"><b>Definition:</b> H5public.h:344</div></div> -<div class="ttc" id="a_h5public_8h_html_a7f81cce70fb546af88da24d9285d3c1c"><div class="ttname"><a href="_h5public_8h.html#a7f81cce70fb546af88da24d9285d3c1c">hsize_t</a></div><div class="ttdeci">uint64_t hsize_t</div><div class="ttdef"><b>Definition:</b> H5public.h:297</div></div> -<div class="ttc" id="a_h5public_8h_html_a8203c78e10ab2d89d8bce688a31afad3"><div class="ttname"><a href="_h5public_8h.html#a8203c78e10ab2d89d8bce688a31afad3">H5_index_t</a></div><div class="ttdeci">H5_index_t</div><div class="ttdef"><b>Definition:</b> H5public.h:367</div></div> -<div class="ttc" id="agroup___h5_a_html_gab9dcfc543cd4282f32b8ea19e08ffa6c"><div class="ttname"><a href="group___h5_a.html#gab9dcfc543cd4282f32b8ea19e08ffa6c">H5Aiterate</a></div><div class="ttdeci">#define H5Aiterate</div><div class="ttdef"><b>Definition:</b> H5version.h:879</div></div> +<div class="ttc" id="a_h5_apublic_8h_html_a28fef0ded9a6c0eb12334c0d15dc3e74"><div class="ttname"><a href="_h5_apublic_8h.html#a28fef0ded9a6c0eb12334c0d15dc3e74">H5A_operator2_t</a></div><div class="ttdeci">herr_t(* H5A_operator2_t)(hid_t location_id, const char *attr_name, const H5A_info_t *ainfo, void *op_data)</div><div class="ttdef"><b>Definition</b> H5Apublic.h:55</div></div> +<div class="ttc" id="a_h5public_8h_html_a6a6ddd1504d1ed61939d46d91d9441b9"><div class="ttname"><a href="_h5public_8h.html#a6a6ddd1504d1ed61939d46d91d9441b9">H5_iter_order_t</a></div><div class="ttdeci">H5_iter_order_t</div><div class="ttdef"><b>Definition</b> H5public.h:344</div></div> +<div class="ttc" id="a_h5public_8h_html_a7f81cce70fb546af88da24d9285d3c1c"><div class="ttname"><a href="_h5public_8h.html#a7f81cce70fb546af88da24d9285d3c1c">hsize_t</a></div><div class="ttdeci">uint64_t hsize_t</div><div class="ttdef"><b>Definition</b> H5public.h:297</div></div> +<div class="ttc" id="a_h5public_8h_html_a8203c78e10ab2d89d8bce688a31afad3"><div class="ttname"><a href="_h5public_8h.html#a8203c78e10ab2d89d8bce688a31afad3">H5_index_t</a></div><div class="ttdeci">H5_index_t</div><div class="ttdef"><b>Definition</b> H5public.h:367</div></div> +<div class="ttc" id="agroup___h5_a_html_gab9dcfc543cd4282f32b8ea19e08ffa6c"><div class="ttname"><a href="group___h5_a.html#gab9dcfc543cd4282f32b8ea19e08ffa6c">H5Aiterate</a></div><div class="ttdeci">#define H5Aiterate</div><div class="ttdef"><b>Definition</b> H5version.h:879</div></div> </div><!-- fragment --><p> <a class="el" href="group___h5_a.html#gab9dcfc543cd4282f32b8ea19e08ffa6c">H5Aiterate</a> successively marches across all of the attributes attached to the object specified in loc_id, performing the operation(s) specified in op_func with the data specified in op_data on each attribute.</p> <p>When <a class="el" href="group___h5_a.html#gab9dcfc543cd4282f32b8ea19e08ffa6c">H5Aiterate</a> is called, index contains the index of the attribute to be accessed in this call. When <a class="el" href="group___h5_a.html#gab9dcfc543cd4282f32b8ea19e08ffa6c">H5Aiterate</a> returns, index will contain the index of the next attribute. If the returned index is the null pointer, then all attributes have been processed, and the iterative process is complete.</p> <p>op_func is a user-defined operation that adheres to the <a class="el" href="_h5version_8h.html#a04b85ea47893cb5538a75130533900a9">H5A_operator_t</a> prototype. This prototype and certain requirements imposed on the operator's behavior are described in the <a class="el" href="group___h5_a.html#gab9dcfc543cd4282f32b8ea19e08ffa6c">H5Aiterate</a> entry in the <a class="el" href="_r_m.html">HDF5 Reference Manual</a>.</p> @@ -387,13 +369,15 @@ Iterating across an Object's Attributes</h3> <h3><a class="anchor" id="subsubsec_attribute_work_delete"></a> Deleting an Attribute</h3> <p>Once an attribute has outlived its usefulness or is no longer appropriate, it may become necessary to delete it.</p> -<p>To delete an attribute, call <a class="el" href="group___h5_a.html#gada9fa3d6db52329f1fd55662de6ff6ba">H5Adelete</a> </p><div class="fragment"><div class="line"><a class="code" href="_h5public_8h.html#a3b079ecf932a5c599499cf7e298af160">herr_t</a> <a class="code" href="group___h5_a.html#gada9fa3d6db52329f1fd55662de6ff6ba">H5Adelete</a> (<a class="code" href="_h5_ipublic_8h.html#a0045db7ff9c22ad35db6ae91662e1943">hid_t</a> loc_id, <span class="keyword">const</span> <span class="keywordtype">char</span> *name)</div> +<p>To delete an attribute, call <a class="el" href="group___h5_a.html#gada9fa3d6db52329f1fd55662de6ff6ba">H5Adelete</a> </p><div class="fragment"><div class="line"><a class="code hl_typedef" href="_h5public_8h.html#a3b079ecf932a5c599499cf7e298af160">herr_t</a> <a class="code hl_function" href="group___h5_a.html#gada9fa3d6db52329f1fd55662de6ff6ba">H5Adelete</a> (<a class="code hl_typedef" href="_h5_ipublic_8h.html#a0045db7ff9c22ad35db6ae91662e1943">hid_t</a> loc_id, <span class="keyword">const</span> <span class="keywordtype">char</span> *name)</div> +<div class="ttc" id="agroup___h5_a_html_gada9fa3d6db52329f1fd55662de6ff6ba"><div class="ttname"><a href="group___h5_a.html#gada9fa3d6db52329f1fd55662de6ff6ba">H5Adelete</a></div><div class="ttdeci">herr_t H5Adelete(hid_t loc_id, const char *attr_name)</div><div class="ttdoc">Deletes an attribute from a specified location.</div></div> </div><!-- fragment --><p> <a class="el" href="group___h5_a.html#gada9fa3d6db52329f1fd55662de6ff6ba">H5Adelete</a> removes the attribute name from the group, dataset, or committed datatype specified in loc_id.</p> <p><a class="el" href="group___h5_a.html#gada9fa3d6db52329f1fd55662de6ff6ba">H5Adelete</a> must not be called if there are any open attribute identifiers on the object loc_id. Such a call can cause the internal attribute indexes to change; future writes to an open attribute would then produce unintended results.</p> <h3><a class="anchor" id="subsubsec_attribute_work_close"></a> Closing an Attribute</h3> <p>As is the case with all HDF5 objects, once access to an attribute it is no longer needed, that attribute must be closed. It is best practice to close it as soon as practicable; it is mandatory that it be closed prior to the H5close call closing the HDF5 Library.</p> -<p>To close an attribute, call <a class="el" href="group___h5_a.html#gaef4394b661e2c930879e9868e122bdda">H5Aclose</a> </p><div class="fragment"><div class="line"><a class="code" href="_h5public_8h.html#a3b079ecf932a5c599499cf7e298af160">herr_t</a> <a class="code" href="group___h5_a.html#gaef4394b661e2c930879e9868e122bdda">H5Aclose</a> (<a class="code" href="_h5_ipublic_8h.html#a0045db7ff9c22ad35db6ae91662e1943">hid_t</a> attr_id)</div> +<p>To close an attribute, call <a class="el" href="group___h5_a.html#gaef4394b661e2c930879e9868e122bdda">H5Aclose</a> </p><div class="fragment"><div class="line"><a class="code hl_typedef" href="_h5public_8h.html#a3b079ecf932a5c599499cf7e298af160">herr_t</a> <a class="code hl_function" href="group___h5_a.html#gaef4394b661e2c930879e9868e122bdda">H5Aclose</a> (<a class="code hl_typedef" href="_h5_ipublic_8h.html#a0045db7ff9c22ad35db6ae91662e1943">hid_t</a> attr_id)</div> +<div class="ttc" id="agroup___h5_a_html_gaef4394b661e2c930879e9868e122bdda"><div class="ttname"><a href="group___h5_a.html#gaef4394b661e2c930879e9868e122bdda">H5Aclose</a></div><div class="ttdeci">herr_t H5Aclose(hid_t attr_id)</div><div class="ttdoc">Closes the specified attribute.</div></div> </div><!-- fragment --><p> <a class="el" href="group___h5_a.html#gaef4394b661e2c930879e9868e122bdda">H5Aclose</a> closes the specified attribute by terminating access to its identifier, attr_id.</p> <h2><a class="anchor" id="subsec_attribute_special"></a> Special Issues</h2> @@ -413,49 +397,49 @@ Special Issues</h2> <tr> <th>Create </th></tr> <tr valign="top"> -<td><div class="fragment"><div class="line"><a name="l00014"></a><span class="lineno"> 14</span>  {</div> -<div class="line"><a name="l00015"></a><span class="lineno"> 15</span>  __label__ fail_acpl, fail_attr, fail_file;</div> -<div class="line"><a name="l00016"></a><span class="lineno"> 16</span>  <a class="code" href="_h5_ipublic_8h.html#a0045db7ff9c22ad35db6ae91662e1943">hid_t</a> file, acpl, fspace, attr;</div> -<div class="line"><a name="l00017"></a><span class="lineno"> 17</span>  </div> -<div class="line"><a name="l00018"></a><span class="lineno"> 18</span>  <span class="keywordtype">unsigned</span> mode = <a class="code" href="_h5_fpublic_8h.html#a5a2d6726f9ad8d2bca8df2b817e5ad6a">H5F_ACC_TRUNC</a>;</div> -<div class="line"><a name="l00019"></a><span class="lineno"> 19</span>  <span class="keywordtype">char</span> file_name[] = <span class="stringliteral">"f1.h5"</span>;</div> -<div class="line"><a name="l00020"></a><span class="lineno"> 20</span>  <span class="comment">// attribute names can be arbitrary Unicode strings</span></div> -<div class="line"><a name="l00021"></a><span class="lineno"> 21</span>  <span class="keywordtype">char</span> attr_name[] = <span class="stringliteral">"Χαρακτηριστικό"</span>;</div> -<div class="line"><a name="l00022"></a><span class="lineno"> 22</span>  </div> -<div class="line"><a name="l00023"></a><span class="lineno"> 23</span>  <span class="keywordflow">if</span> ((file = <a class="code" href="group___h5_f.html#gae64b51ee9ac0781bc4ccc599d98387f4">H5Fcreate</a>(file_name, mode, <a class="code" href="_h5_ppublic_8h.html#afa85e97bfbf9bf1c58e39263846c568f">H5P_DEFAULT</a>, <a class="code" href="_h5_ppublic_8h.html#afa85e97bfbf9bf1c58e39263846c568f">H5P_DEFAULT</a>)) == <a class="code" href="_h5_ipublic_8h.html#a01eab13dccc91afd6909d74dccb780ba">H5I_INVALID_HID</a>) {</div> -<div class="line"><a name="l00024"></a><span class="lineno"> 24</span>  ret_val = EXIT_FAILURE;</div> -<div class="line"><a name="l00025"></a><span class="lineno"> 25</span>  <span class="keywordflow">goto</span> fail_file;</div> -<div class="line"><a name="l00026"></a><span class="lineno"> 26</span>  }</div> -<div class="line"><a name="l00027"></a><span class="lineno"> 27</span>  <span class="keywordflow">if</span> ((acpl = <a class="code" href="group___p_l_c_r.html#gaf1b11da01d4d45d788c45f8bc5f0cbfa">H5Pcreate</a>(<a class="code" href="_h5_ppublic_8h.html#aa0102211c679e031e2e9831b66c48a12">H5P_ATTRIBUTE_CREATE</a>)) == <a class="code" href="_h5_ipublic_8h.html#a01eab13dccc91afd6909d74dccb780ba">H5I_INVALID_HID</a>) {</div> -<div class="line"><a name="l00028"></a><span class="lineno"> 28</span>  ret_val = EXIT_FAILURE;</div> -<div class="line"><a name="l00029"></a><span class="lineno"> 29</span>  <span class="keywordflow">goto</span> fail_acpl;</div> -<div class="line"><a name="l00030"></a><span class="lineno"> 30</span>  }</div> -<div class="line"><a name="l00031"></a><span class="lineno"> 31</span>  <span class="comment">// use UTF-8 encoding for the attribute name</span></div> -<div class="line"><a name="l00032"></a><span class="lineno"> 32</span>  <span class="keywordflow">if</span> (<a class="code" href="group___a_c_p_l.html#gad4fa8e2d17236786f770cf17eef908cc">H5Pset_char_encoding</a>(acpl, <a class="code" href="_h5_tpublic_8h.html#a03755b8370672668ddc7063add28e71aa41685667f69bf81eb7de5dd5f452e658">H5T_CSET_UTF8</a>) < 0) {</div> -<div class="line"><a name="l00033"></a><span class="lineno"> 33</span>  ret_val = EXIT_FAILURE;</div> -<div class="line"><a name="l00034"></a><span class="lineno"> 34</span>  <span class="keywordflow">goto</span> fail_fspace;</div> -<div class="line"><a name="l00035"></a><span class="lineno"> 35</span>  }</div> -<div class="line"><a name="l00036"></a><span class="lineno"> 36</span>  <span class="comment">// create a scalar (singleton) attribute</span></div> -<div class="line"><a name="l00037"></a><span class="lineno"> 37</span>  <span class="keywordflow">if</span> ((fspace = <a class="code" href="group___h5_s.html#gabee514327cba34ca9951b24fa14fb083">H5Screate</a>(<a class="code" href="_h5_spublic_8h.html#ae53f3c6a52563646fbac9ead8ecdbf0aaf6a34a2439db8aa7bb63ed0c4aaa5eb8">H5S_SCALAR</a>)) == <a class="code" href="_h5_ipublic_8h.html#a01eab13dccc91afd6909d74dccb780ba">H5I_INVALID_HID</a>) {</div> -<div class="line"><a name="l00038"></a><span class="lineno"> 38</span>  ret_val = EXIT_FAILURE;</div> -<div class="line"><a name="l00039"></a><span class="lineno"> 39</span>  <span class="keywordflow">goto</span> fail_fspace;</div> -<div class="line"><a name="l00040"></a><span class="lineno"> 40</span>  }</div> -<div class="line"><a name="l00041"></a><span class="lineno"> 41</span>  <span class="comment">// create an attribute on the root group</span></div> -<div class="line"><a name="l00042"></a><span class="lineno"> 42</span>  <span class="keywordflow">if</span> ((attr = <a class="code" href="group___h5_a.html#ga4f4e5248c09f689633079ed8afc0b308">H5Acreate2</a>(file, attr_name, <a class="code" href="group___p_d_t_s_t_d.html#ga8db8c9c2bcc457f9f8526c8fcb81218b">H5T_STD_I32LE</a>, fspace, acpl, <a class="code" href="_h5_ppublic_8h.html#afa85e97bfbf9bf1c58e39263846c568f">H5P_DEFAULT</a>)) ==</div> -<div class="line"><a name="l00043"></a><span class="lineno"> 43</span>  <a class="code" href="_h5_ipublic_8h.html#a01eab13dccc91afd6909d74dccb780ba">H5I_INVALID_HID</a>) {</div> -<div class="line"><a name="l00044"></a><span class="lineno"> 44</span>  ret_val = EXIT_FAILURE;</div> -<div class="line"><a name="l00045"></a><span class="lineno"> 45</span>  <span class="keywordflow">goto</span> fail_attr;</div> -<div class="line"><a name="l00046"></a><span class="lineno"> 46</span>  }</div> -<div class="line"><a name="l00047"></a><span class="lineno"> 47</span>  </div> -<div class="line"><a name="l00048"></a><span class="lineno"> 48</span>  <a class="code" href="group___h5_a.html#gaef4394b661e2c930879e9868e122bdda">H5Aclose</a>(attr);</div> -<div class="line"><a name="l00049"></a><span class="lineno"> 49</span> fail_attr:</div> -<div class="line"><a name="l00050"></a><span class="lineno"> 50</span>  <a class="code" href="group___h5_s.html#ga2b53128a39c8f104c1c9c2a91590fcc1">H5Sclose</a>(fspace);</div> -<div class="line"><a name="l00051"></a><span class="lineno"> 51</span> fail_fspace:</div> -<div class="line"><a name="l00052"></a><span class="lineno"> 52</span>  <a class="code" href="group___p_l_c_r.html#ga5dce61149211d3ef319452aa598887fb">H5Pclose</a>(acpl);</div> -<div class="line"><a name="l00053"></a><span class="lineno"> 53</span> fail_acpl:</div> -<div class="line"><a name="l00054"></a><span class="lineno"> 54</span>  <a class="code" href="group___h5_f.html#gac55cd91d80822e4f8c2a7f04ea71b124">H5Fclose</a>(file);</div> -<div class="line"><a name="l00055"></a><span class="lineno"> 55</span> fail_file:;</div> -<div class="line"><a name="l00056"></a><span class="lineno"> 56</span>  }</div> +<td><div class="fragment"><div class="line"><span class="lineno"> 14</span> {</div> +<div class="line"><span class="lineno"> 15</span> __label__ fail_acpl, fail_attr, fail_file;</div> +<div class="line"><span class="lineno"> 16</span> <a class="code hl_typedef" href="_h5_ipublic_8h.html#a0045db7ff9c22ad35db6ae91662e1943">hid_t</a> file, acpl, fspace, attr;</div> +<div class="line"><span class="lineno"> 17</span> </div> +<div class="line"><span class="lineno"> 18</span> <span class="keywordtype">unsigned</span> mode = <a class="code hl_define" href="_h5_fpublic_8h.html#a5a2d6726f9ad8d2bca8df2b817e5ad6a">H5F_ACC_TRUNC</a>;</div> +<div class="line"><span class="lineno"> 19</span> <span class="keywordtype">char</span> file_name[] = <span class="stringliteral">"f1.h5"</span>;</div> +<div class="line"><span class="lineno"> 20</span> <span class="comment">// attribute names can be arbitrary Unicode strings</span></div> +<div class="line"><span class="lineno"> 21</span> <span class="keywordtype">char</span> attr_name[] = <span class="stringliteral">"Χαρακτηριστικό"</span>;</div> +<div class="line"><span class="lineno"> 22</span> </div> +<div class="line"><span class="lineno"> 23</span> <span class="keywordflow">if</span> ((file = <a class="code hl_function" href="group___h5_f.html#gae64b51ee9ac0781bc4ccc599d98387f4">H5Fcreate</a>(file_name, mode, <a class="code hl_define" href="_h5_ppublic_8h.html#afa85e97bfbf9bf1c58e39263846c568f">H5P_DEFAULT</a>, <a class="code hl_define" href="_h5_ppublic_8h.html#afa85e97bfbf9bf1c58e39263846c568f">H5P_DEFAULT</a>)) == <a class="code hl_define" href="_h5_ipublic_8h.html#a01eab13dccc91afd6909d74dccb780ba">H5I_INVALID_HID</a>) {</div> +<div class="line"><span class="lineno"> 24</span> ret_val = EXIT_FAILURE;</div> +<div class="line"><span class="lineno"> 25</span> <span class="keywordflow">goto</span> fail_file;</div> +<div class="line"><span class="lineno"> 26</span> }</div> +<div class="line"><span class="lineno"> 27</span> <span class="keywordflow">if</span> ((acpl = <a class="code hl_function" href="group___p_l_c_r.html#gaf1b11da01d4d45d788c45f8bc5f0cbfa">H5Pcreate</a>(<a class="code hl_define" href="_h5_ppublic_8h.html#aa0102211c679e031e2e9831b66c48a12">H5P_ATTRIBUTE_CREATE</a>)) == <a class="code hl_define" href="_h5_ipublic_8h.html#a01eab13dccc91afd6909d74dccb780ba">H5I_INVALID_HID</a>) {</div> +<div class="line"><span class="lineno"> 28</span> ret_val = EXIT_FAILURE;</div> +<div class="line"><span class="lineno"> 29</span> <span class="keywordflow">goto</span> fail_acpl;</div> +<div class="line"><span class="lineno"> 30</span> }</div> +<div class="line"><span class="lineno"> 31</span> <span class="comment">// use UTF-8 encoding for the attribute name</span></div> +<div class="line"><span class="lineno"> 32</span> <span class="keywordflow">if</span> (<a class="code hl_function" href="group___a_c_p_l.html#gad4fa8e2d17236786f770cf17eef908cc">H5Pset_char_encoding</a>(acpl, <a class="code hl_enumvalue" href="_h5_tpublic_8h.html#a03755b8370672668ddc7063add28e71aa41685667f69bf81eb7de5dd5f452e658">H5T_CSET_UTF8</a>) < 0) {</div> +<div class="line"><span class="lineno"> 33</span> ret_val = EXIT_FAILURE;</div> +<div class="line"><span class="lineno"> 34</span> <span class="keywordflow">goto</span> fail_fspace;</div> +<div class="line"><span class="lineno"> 35</span> }</div> +<div class="line"><span class="lineno"> 36</span> <span class="comment">// create a scalar (singleton) attribute</span></div> +<div class="line"><span class="lineno"> 37</span> <span class="keywordflow">if</span> ((fspace = <a class="code hl_function" href="group___h5_s.html#gabee514327cba34ca9951b24fa14fb083">H5Screate</a>(<a class="code hl_enumvalue" href="_h5_spublic_8h.html#ae53f3c6a52563646fbac9ead8ecdbf0aaf6a34a2439db8aa7bb63ed0c4aaa5eb8">H5S_SCALAR</a>)) == <a class="code hl_define" href="_h5_ipublic_8h.html#a01eab13dccc91afd6909d74dccb780ba">H5I_INVALID_HID</a>) {</div> +<div class="line"><span class="lineno"> 38</span> ret_val = EXIT_FAILURE;</div> +<div class="line"><span class="lineno"> 39</span> <span class="keywordflow">goto</span> fail_fspace;</div> +<div class="line"><span class="lineno"> 40</span> }</div> +<div class="line"><span class="lineno"> 41</span> <span class="comment">// create an attribute on the root group</span></div> +<div class="line"><span class="lineno"> 42</span> <span class="keywordflow">if</span> ((attr = <a class="code hl_function" href="group___h5_a.html#ga4f4e5248c09f689633079ed8afc0b308">H5Acreate2</a>(file, attr_name, <a class="code hl_define" href="group___p_d_t_s_t_d.html#ga8db8c9c2bcc457f9f8526c8fcb81218b">H5T_STD_I32LE</a>, fspace, acpl, <a class="code hl_define" href="_h5_ppublic_8h.html#afa85e97bfbf9bf1c58e39263846c568f">H5P_DEFAULT</a>)) ==</div> +<div class="line"><span class="lineno"> 43</span> <a class="code hl_define" href="_h5_ipublic_8h.html#a01eab13dccc91afd6909d74dccb780ba">H5I_INVALID_HID</a>) {</div> +<div class="line"><span class="lineno"> 44</span> ret_val = EXIT_FAILURE;</div> +<div class="line"><span class="lineno"> 45</span> <span class="keywordflow">goto</span> fail_attr;</div> +<div class="line"><span class="lineno"> 46</span> }</div> +<div class="line"><span class="lineno"> 47</span> </div> +<div class="line"><span class="lineno"> 48</span> <a class="code hl_function" href="group___h5_a.html#gaef4394b661e2c930879e9868e122bdda">H5Aclose</a>(attr);</div> +<div class="line"><span class="lineno"> 49</span>fail_attr:</div> +<div class="line"><span class="lineno"> 50</span> <a class="code hl_function" href="group___h5_s.html#ga2b53128a39c8f104c1c9c2a91590fcc1">H5Sclose</a>(fspace);</div> +<div class="line"><span class="lineno"> 51</span>fail_fspace:</div> +<div class="line"><span class="lineno"> 52</span> <a class="code hl_function" href="group___p_l_c_r.html#ga5dce61149211d3ef319452aa598887fb">H5Pclose</a>(acpl);</div> +<div class="line"><span class="lineno"> 53</span>fail_acpl:</div> +<div class="line"><span class="lineno"> 54</span> <a class="code hl_function" href="group___h5_f.html#gac55cd91d80822e4f8c2a7f04ea71b124">H5Fclose</a>(file);</div> +<div class="line"><span class="lineno"> 55</span>fail_file:;</div> +<div class="line"><span class="lineno"> 56</span> }</div> </div><!-- fragment --> </td></tr> </table> <h4>Large Attributes Stored in a Separate Dataset</h4> @@ -491,7 +475,7 @@ A large or shared HDF5 attribute and its associated dataset(s)</div></div> <ul> <li class="footer">Generated by <a href="http://www.doxygen.org/index.html"> - <img class="footer" src="doxygen.png" alt="doxygen"/></a> 1.9.1 </li> + <img class="footer" src="doxygen.png" alt="doxygen"/></a> 1.10.0 </li> </ul> </div> </body> |