mirror of
https://github.com/HDFGroup/hdf5.git
synced 2025-02-17 16:10:24 +08:00
RM_H5Front.html Added new Fortran90 functions and links. Related edits. Added "Describes HDF5 Release..." line in page footers. Minor editorial corrections.
3020 lines
123 KiB
HTML
3020 lines
123 KiB
HTML
<html>
|
|
<head><title>
|
|
HDF5/H5P API Specification
|
|
</title></head>
|
|
|
|
<body bgcolor="#FFFFFF">
|
|
|
|
|
|
<hr>
|
|
<center>
|
|
<table border=0 width=98%>
|
|
<tr><td valign=top align=left>
|
|
<a href="H5.intro.html">Introduction to HDF5</a> <br>
|
|
<a href="H5.user.html">HDF5 User Guide</a> <br>
|
|
<a href="index.html">Other HDF5 documents and links</a> <br>
|
|
<!--
|
|
<a href="Glossary.html">Glossary</a><br>
|
|
-->
|
|
</td>
|
|
<td valign=top align=right>
|
|
And in this document, the
|
|
<a href="RM_H5Front.html">HDF5 Reference Manual</a>
|
|
<br>
|
|
<a href="RM_H5.html">H5</a>
|
|
<a href="RM_H5A.html">H5A</a>
|
|
<a href="RM_H5D.html">H5D</a>
|
|
<a href="RM_H5E.html">H5E</a>
|
|
<a href="RM_H5F.html">H5F</a>
|
|
<a href="RM_H5G.html">H5G</a>
|
|
<a href="RM_H5I.html">H5I</a>
|
|
<br>
|
|
H5P
|
|
<a href="RM_H5R.html">H5R</a>
|
|
<a href="RM_H5RA.html">H5RA</a>
|
|
<a href="RM_H5S.html">H5S</a>
|
|
<a href="RM_H5T.html">H5T</a>
|
|
<a href="RM_H5Z.html">H5Z</a>
|
|
<a href="Tools.html">Tools</a>
|
|
</td></tr>
|
|
</table>
|
|
</center>
|
|
<hr>
|
|
|
|
|
|
<center>
|
|
<h1>H5P: Property List Interface</h1>
|
|
</center>
|
|
<h2>Property List API Functions</h2>
|
|
|
|
These functions manipulate property list objects to allow objects which require
|
|
many different parameters to be easily manipulated.
|
|
|
|
|
|
<p>
|
|
<strong>The C Interfaces:</strong>
|
|
|
|
<table border=0>
|
|
<tr><td valign=top>
|
|
|
|
<i>General Property List Operations</i>
|
|
<ul>
|
|
<li><a href="#Property-Create">H5Pcreate</a>
|
|
<li><a href="#Property-GetClass">H5Pget_class</a>
|
|
<li><a href="#Property-Copy">H5Pcopy</a>
|
|
<li><a href="#Property-Close">H5Pclose</a>
|
|
</ul>
|
|
|
|
<p><i>File Creation Properties</i>
|
|
<ul>
|
|
<li><a href="#Property-GetVersion">H5Pget_version</a>
|
|
<li><a href="#Property-SetUserblock">H5Pset_userblock</a>
|
|
<li><a href="#Property-GetUserblock">H5Pget_userblock</a>
|
|
<li><a href="#Property-SetSizes">H5Pset_sizes</a>
|
|
<li><a href="#Property-GetSizes">H5Pget_sizes</a>
|
|
<li><a href="#Property-SetSymK">H5Pset_sym_k</a>
|
|
<li><a href="#Property-GetSymK">H5Pget_sym_k</a>
|
|
<li><a href="#Property-SetIstoreK">H5Pset_istore_k</a>
|
|
<li><a href="#Property-GetIstoreK">H5Pget_istore_k</a>
|
|
</ul>
|
|
|
|
<p><i>Variable-length Datatype Properties</i>
|
|
<ul>
|
|
<li><a href="#Property-SetVLMemManager">H5Pset_vlen_mem_manager</a>
|
|
<li><a href="#Property-GetVLMemManager">H5Pget_vlen_mem_manager</a>
|
|
</ul>
|
|
|
|
</td><td> </td><td valign=top>
|
|
|
|
<i>File Access Properties</i>
|
|
<ul>
|
|
<li><a href="#Property-GetDriver">H5Pget_driver</a>
|
|
<li><a href="#Property-SetStdio">H5Pset_stdio</a>
|
|
<li><a href="#Property-GetStdio">H5Pget_stdio</a>
|
|
<li><a href="#Property-SetSec2">H5Pset_sec2</a>
|
|
<li><a href="#Property-GetSec2">H5Pget_sec2</a>
|
|
<li><a href="#Property-SetAlignment">H5Pset_alignment</a>
|
|
<li><a href="#Property-GetAlignment">H5Pget_alignment</a>
|
|
<li><a href="#Property-SetCore">H5Pset_core</a>
|
|
<li><a href="#Property-GetCore">H5Pget_core</a>
|
|
<li><a href="#Property-SetMPI">H5Pset_mpi</a> ||
|
|
<li><a href="#Property-GetMPI">H5Pget_mpi</a> ||
|
|
<!-- Not implemented. Probably never will be.
|
|
<li><a href="#Property-SetFamily">H5Pset_family</a>
|
|
<li><a href="#Property-GetFamily">H5Pget_family</a>
|
|
-->
|
|
<li><a href="#Property-SetCache">H5Pset_cache</a>
|
|
<li><a href="#Property-GetCache">H5Pget_cache</a>
|
|
<li><a href="#Property-SetSplit">H5Pset_split</a>
|
|
<li><a href="#Property-GetSplit">H5Pget_split</a>
|
|
<li><a href="#Property-SetGCReferences">H5Pset_gc_references</a>
|
|
<li><a href="#Property-GetGCReferences">H5Pget_gc_references</a>
|
|
</ul>
|
|
|
|
<br>
|
|
<br>
|
|
<br>
|
|
<br>
|
|
<br>
|
|
<br>
|
|
<br>
|
|
|| <i>Available only in the parallel HDF5 library.</i>
|
|
|
|
</td><td> </td><td valign=top>
|
|
|
|
<i>Dataset Creation Properties</i>
|
|
<ul>
|
|
<li><a href="#Property-SetLayout">H5Pset_layout</a>
|
|
<li><a href="#Property-GetLayout">H5Pget_layout</a>
|
|
<li><a href="#Property-SetChunk">H5Pset_chunk</a>
|
|
<li><a href="#Property-GetChunk">H5Pget_chunk</a>
|
|
<li><a href="#Property-SetDeflate">H5Pset_deflate</a>
|
|
<!--
|
|
<li><a href="#Property-GetDeflate">H5Pget_deflate</a>
|
|
<li><a href="#Property-SetCompression">H5Pset_compression</a>
|
|
<li><a href="#Property-GetCompression">H5Pget_compression</a>
|
|
-->
|
|
<li><a href="#Property-SetFillValue">H5Pset_fill_value</a>
|
|
<li><a href="#Property-GetFillValue">H5Pget_fill_value</a>
|
|
<li><a href="#Property-SetFilter">H5Pset_filter</a>
|
|
<li><a href="#Property-GetNFilters">H5Pget_nfilters</a>
|
|
<li><a href="#Property-GetFilter">H5Pget_filter</a>
|
|
<li><a href="#Property-SetExternal">H5Pset_external</a>
|
|
<li><a href="#Property-GetExternalCount">H5Pget_external_count</a>
|
|
<li><a href="#Property-GetExternal">H5Pget_external</a>
|
|
</ul>
|
|
|
|
<p><i>Dataset Memory and Transfer Properties</i>
|
|
<ul>
|
|
<li><a href="#Property-SetBuffer">H5Pset_buffer</a>
|
|
<li><a href="#Property-GetBuffer">H5Pget_buffer</a>
|
|
<li><a href="#Property-SetPreserve">H5Pset_preserve</a>
|
|
<li><a href="#Property-GetPreserve">H5Pget_preserve</a>
|
|
<li><a href="#Property-SetHyperCache">H5Pset_hyper_cache</a>
|
|
<li><a href="#Property-GetHyperCache">H5Pget_hyper_cache</a>
|
|
<li><a href="#Property-SetBTreeRatios">H5Pset_btree_ratios</a>
|
|
<li><a href="#Property-GetBTreeRatios">H5Pget_btree_ratios</a>
|
|
<li><a href="#Property-SetXfer">H5Pset_xfer</a> ||
|
|
<li><a href="#Property-GetXfer">H5Pget_xfer</a> ||
|
|
</ul>
|
|
|
|
</td></tr>
|
|
|
|
<!--
|
|
<tr><td colspan=5 align=right>
|
|
<br>
|
|
|| <i>Available only in the parallel HDF5 library.</i>
|
|
</td></tr>
|
|
-->
|
|
|
|
</table>
|
|
|
|
<p>
|
|
<strong>The FORTRAN90 Interfaces:</strong>
|
|
|
|
<br>
|
|
<font size=-1>
|
|
<i>In general, each FORTRAN90 subroutine performs exactly the same task
|
|
as the corresponding C function. The links below go to the C function
|
|
descriptions, which serve as general descriptions for both. A button,
|
|
under <strong>Non-C API(s)</strong> at the end of the C function description,
|
|
opens an external browser window displaying the FORTRAN90-specific
|
|
information. You will probably want to adjust the size and location of
|
|
this external window so that both browser windows are visible and to
|
|
facilitate moving easily between them.</i>
|
|
</font>
|
|
|
|
<table border=0>
|
|
<tr><td valign=top>
|
|
|
|
<i>General Property List Operations</i>
|
|
<ul>
|
|
<li><a href="#Property-Create">h5pcreate_f</a>
|
|
<li><a href="#Property-GetClass">h5pget_class_f</a>
|
|
<li><a href="#Property-Copy">h5pcopy_f</a>
|
|
<li><a href="#Property-Close">h5pclose_f</a>
|
|
</ul>
|
|
|
|
<p><i>File Creation Properties</i>
|
|
<ul>
|
|
<li><a href="#Property-GetVersion">h5pget_version_f</a>
|
|
<li><a href="#Property-SetUserblock">h5pset_userblock_f</a>
|
|
<li><a href="#Property-GetUserblock">h5pget_userblock_f</a>
|
|
<li><a href="#Property-SetSizes">h5pset_sizes_f</a>
|
|
<li><a href="#Property-GetSizes">h5pget_sizes_f</a>
|
|
<li><a href="#Property-SetSymK">h5pset_sym_k_f</a>
|
|
<li><a href="#Property-GetSymK">h5pget_sym_k_f</a>
|
|
<li><a href="#Property-SetIstoreK">h5pset_istore_k_f</a>
|
|
<li><a href="#Property-GetIstoreK">h5pget_istore_k_f</a>
|
|
</ul>
|
|
|
|
<!--<p><i>Variable-length Datatype Properties</i> -->
|
|
<!--<ul> -->
|
|
<!--<li><a href="#Property-SetVLMemManager">h5pset_vlen_mem_manager_f</a> -->
|
|
<!--<li><a href="#Property-GetVLMemManager">h5pget_vlen_mem_manager_f</a> -->
|
|
<!--</ul> -->
|
|
|
|
</td><td> </td><td valign=top>
|
|
|
|
|
|
<i>File Access Properties</i>
|
|
<ul>
|
|
<li><a href="#Property-GetDriver">h5pget_driver_f</a>
|
|
<li><a href="#Property-SetStdio">h5pset_stdio_f</a>
|
|
<li><a href="#Property-GetStdio">h5pget_stdio_f</a>
|
|
<li><a href="#Property-SetSec2">h5pset_sec2_f</a>
|
|
<li><a href="#Property-GetSec2">h5pget_sec2_f</a>
|
|
<li><a href="#Property-SetAlignment">h5pset_alignment_f</a>
|
|
<li><a href="#Property-GetAlignment">h5pget_alignment_f</a>
|
|
<li><a href="#Property-SetCore">h5pset_core_f</a>
|
|
<li><a href="#Property-GetCore">h5pget_core_f</a>
|
|
<li><a href="#Property-SetMPI">h5pset_mpi_f</a> ||
|
|
<li><a href="#Property-GetMPI">h5pget_mpi_f</a> ||
|
|
<!--<li><a href="#Property-SetFamily">h5pset_family_f</a> -->
|
|
<!--<li><a href="#Property-GetFamily">h5pget_family_f</a> -->
|
|
<li><a href="#Property-SetCache">h5pset_cache_f</a>
|
|
<li><a href="#Property-GetCache">h5pget_cache_f</a>
|
|
<li><a href="#Property-SetSplit">h5pset_split_f</a>
|
|
<li><a href="#Property-GetSplit">h5pget_split_f</a>
|
|
<li><a href="#Property-SetGCReferences">h5pset_gc_references_f</a>
|
|
<li><a href="#Property-GetGCReferences">h5pget_gc_references_f</a>
|
|
</ul>
|
|
|
|
<!--
|
|
<br>
|
|
<br>
|
|
<br>
|
|
<br>
|
|
<br>
|
|
-->
|
|
<br>
|
|
<br>
|
|
|| <i>Available only in the parallel HDF5 library.</i>
|
|
|
|
|
|
</td><td> </td><td valign=top>
|
|
|
|
<i>Dataset Creation Properties</i>
|
|
<ul>
|
|
<li><a href="#Property-SetLayout">h5pset_layout_f</a>
|
|
<li><a href="#Property-GetLayout">h5pget_layout_f</a>
|
|
<li><a href="#Property-SetChunk">h5pset_chunk_f</a>
|
|
<li><a href="#Property-GetChunk">h5pget_chunk_f</a>
|
|
<li><a href="#Property-SetDeflate">h5pset_deflate_f</a>
|
|
<!--<li><a href="#Property-GetDeflate">h5pget_deflate_f</a> -->
|
|
<!--<li><a href="#Property-SetCompression">h5pset_compression_f</a> -->
|
|
<!--<li><a href="#Property-GetCompression">h5pget_compression_f</a> -->
|
|
<li><a href="#Property-SetFillValue">h5pset_fill_value_f</a>
|
|
<li><a href="#Property-GetFillValue">h5pget_fill_value_f</a>
|
|
<li><a href="#Property-SetFilter">h5pset_filter_f</a>
|
|
<!--<li><a href="#Property-GetNFilters">h5pget_nfilters_f</a> -->
|
|
<li><a href="#Property-GetFilter">h5pget_filter_f</a>
|
|
<li><a href="#Property-SetExternal">h5pset_external_f</a>
|
|
<li><a href="#Property-GetExternalCount">h5pget_external_count_f</a>
|
|
<li><a href="#Property-GetExternal">h5pget_external_f</a>
|
|
</ul>
|
|
|
|
<p><i>Dataset Memory and Transfer Properties</i>
|
|
<ul>
|
|
<!--<li><a href="#Property-SetBuffer">h5pset_buffer_f</a> -->
|
|
<!--<li><a href="#Property-GetBuffer">h5pget_buffer_f</a> -->
|
|
<!--<li><a href="#Property-SetPreserve">h5pset_preserve_f</a> -->
|
|
<!--<li><a href="#Property-GetPreserve">h5pget_preserve_f</a> -->
|
|
<li><a href="#Property-SetHyperCache">h5pset_hyper_cache_f</a>
|
|
<li><a href="#Property-GetHyperCache">h5pget_hyper_cache_f</a>
|
|
<li><a href="#Property-SetBTreeRatios">h5pset_btree_ratios_f</a>
|
|
<li><a href="#Property-GetBTreeRatios">h5pget_btree_ratios_f</a>
|
|
<li><a href="#Property-SetXfer">h5pset_xfer_f</a> ||
|
|
<li><a href="#Property-GetXfer">h5pget_xfer_f</a> ||
|
|
</ul>
|
|
|
|
</td></tr>
|
|
</table>
|
|
|
|
<hr>
|
|
<dl>
|
|
<dt><strong>Name:</strong> <a name="Property-Create">H5Pcreate</a>
|
|
<dt><strong>Signature:</strong>
|
|
<dd><em>hid_t </em><code>H5Pcreate</code>(<em>H5P_class_t</em> <code>type</code>
|
|
)
|
|
<dt><strong>Purpose:</strong>
|
|
<dd>Creates a new property as an instance of a property list class.
|
|
<dt><strong>Description:</strong>
|
|
<dd><code>H5Pcreate</code> creates a new property as an instance of some
|
|
property list class. The new property list is initialized
|
|
with default values for the specified class. The classes are:
|
|
<dl>
|
|
<dt><code>H5P_FILE_CREATE</code>
|
|
<dd>Properties for file creation.
|
|
See <a href="Files.html">Files</a>
|
|
in the <cite>HDF User's Guide</cite>
|
|
for details about the file creation properties.
|
|
<dt><code>H5P_FILE_ACCESS</code>
|
|
<dd>Properties for file access.
|
|
See <a href="Files.html">Files</a>
|
|
in the <cite>HDF User's Guide</cite>
|
|
for details about the file creation properties.
|
|
<dt><code>H5P_DATASET_CREATE</code>
|
|
<dd>Properties for dataset creation.
|
|
See <a href="Datasets.html">Datasets</a>
|
|
in the <cite>HDF User's Guide</cite>
|
|
for details about dataset creation properties.
|
|
<dt><code>H5P_DATASET_XFER</code>
|
|
<dd>Properties for raw data transfer.
|
|
See <a href="Datasets.html">Datasets</a>
|
|
in the <cite>HDF User's Guide</cite>
|
|
for details about raw data transfer properties.
|
|
<dt><code>H5P_MOUNT</code>
|
|
<dd>Properties for file mounting.
|
|
With this parameter, <code>H5Pcreate</code>
|
|
creates and returns a new mount property list
|
|
initialized with default values.
|
|
</dl>
|
|
<dt><strong>Parameters:</strong>
|
|
<dl>
|
|
<dt><em>H5P_class_t</em> <code>type</code>
|
|
<dd>IN: The type of property list to create.
|
|
</dl>
|
|
<dt><strong>Returns:</strong>
|
|
<dd>Returns a property list identifier (<code>plist</code>) if successful;
|
|
otherwise Fail (-1).
|
|
<dt><strong>Non-C API(s):</strong>
|
|
<dd><a href="fortran/h5p_FORTRAN.html#h5pcreate_f"
|
|
target="FortranWin"><img src="Graphics/FORTRAN.gif" border=0></a>
|
|
<!--
|
|
<img src="Graphics/Java.gif">
|
|
<img src="Graphics/C++.gif">
|
|
-->
|
|
</dl>
|
|
|
|
<hr>
|
|
<dl>
|
|
<dt><strong>Name:</strong> <a name="Property-Close">H5Pclose</a>
|
|
<dt><strong>Signature:</strong>
|
|
<dd><em>herr_t </em><code>H5Pclose</code>(<em>hid_t</em> <code>plist</code>
|
|
)
|
|
<dt><strong>Purpose:</strong>
|
|
<dd>Terminates access to a property list.
|
|
<dt><strong>Description:</strong>
|
|
<dd><code>H5Pclose</code> terminates access to a property list.
|
|
All property lists should be closed when the application is
|
|
finished accessing them.
|
|
This frees resources used by the property list.
|
|
<dt><strong>Parameters:</strong>
|
|
<dl>
|
|
<dt><em>hid_t</em> <code>plist</code>
|
|
<dd>IN: Identifier of the property list to terminate access to.
|
|
</dl>
|
|
<dt><strong>Returns:</strong>
|
|
<dd>Returns a non-negative value if successful;
|
|
otherwise returns a negative value.
|
|
<dt><strong>Non-C API(s):</strong>
|
|
<dd><a href="fortran/h5p_FORTRAN.html#h5pclose_f"
|
|
target="FortranWin"><img src="Graphics/FORTRAN.gif" border=0></a>
|
|
<!--
|
|
<img src="Graphics/Java.gif">
|
|
<img src="Graphics/C++.gif">
|
|
-->
|
|
</dl>
|
|
|
|
|
|
<hr>
|
|
<dl>
|
|
<dt><strong>Name:</strong> <a name="Property-GetClass">H5Pget_class</a>
|
|
<dt><strong>Signature:</strong>
|
|
<dd><em>H5P_class_t </em><code>H5Pget_class</code>(<em>hid_t</em> <code>plist</code>
|
|
)
|
|
<dt><strong>Purpose:</strong>
|
|
<dd>Returns the property list class for a property list.
|
|
<dt><strong>Description:</strong>
|
|
<dd><code>H5Pget_class</code> returns the property list class for the
|
|
property list identified by the <code>plist</code> parameter.
|
|
Valid property list classes are defined in the description of
|
|
<code>H5Pcreate()</code>.
|
|
<dt><strong>Parameters:</strong>
|
|
<dl>
|
|
<dt><em>hid_t</em> <code>plist</code>
|
|
<dd>IN: Identifier of property list to query.
|
|
</dl>
|
|
<dt><strong>Returns:</strong>
|
|
<dd>Returns a property list class if successful.
|
|
Otherwise returns H5P_NO_CLASS (-1).
|
|
<dt><strong>Non-C API(s):</strong>
|
|
<dd><a href="fortran/h5p_FORTRAN.html#h5pget_class_f"
|
|
target="FortranWin"><img src="Graphics/FORTRAN.gif" border=0></a>
|
|
<!--
|
|
<img src="Graphics/Java.gif">
|
|
<img src="Graphics/C++.gif">
|
|
-->
|
|
</dl>
|
|
|
|
|
|
<hr>
|
|
<dl>
|
|
<dt><strong>Name:</strong> <a name="Property-Copy">H5Pcopy</a>
|
|
<dt><strong>Signature:</strong>
|
|
<dd><em>hid_t </em><code>H5Pcopy</code>(<em>hid_t</em> <code>plist</code>
|
|
)
|
|
<dt><strong>Purpose:</strong>
|
|
<dd>Copies an existing property list to create a new property list.
|
|
<dt><strong>Description:</strong>
|
|
<dd><code>H5Pcopy</code> copies an existing property list to create
|
|
a new property list.
|
|
The new property list has the same properties and values
|
|
as the original property list.
|
|
<dt><strong>Parameters:</strong>
|
|
<dl>
|
|
<dt><em>hid_t</em> <code>plist</code>
|
|
<dd>IN: Identifier of property list to duplicate.
|
|
</dl>
|
|
<dt><strong>Returns:</strong>
|
|
<dd>Returns a property list identifier if successful;
|
|
otherwise returns a negative value.
|
|
<dt><strong>Non-C API(s):</strong>
|
|
<dd><a href="fortran/h5p_FORTRAN.html#h5pcopy_f"
|
|
target="FortranWin"><img src="Graphics/FORTRAN.gif" border=0></a>
|
|
<!--
|
|
<img src="Graphics/Java.gif">
|
|
<img src="Graphics/C++.gif">
|
|
-->
|
|
</dl>
|
|
|
|
|
|
<hr>
|
|
<dl>
|
|
<dt><strong>Name:</strong> <a name="Property-GetVersion">H5Pget_version</a>
|
|
<dt><strong>Signature:</strong>
|
|
<dd><em>herr_t </em><code>H5Pget_version</code>(<em>hid_t</em> <code>plist</code>,
|
|
<em>int *</em> <code>super</code>,
|
|
<em>int *</em> <code>freelist</code>,
|
|
<em>int *</em> <code>stab</code>,
|
|
<em>int *</em> <code>shhdr</code>
|
|
)
|
|
<dt><strong>Purpose:</strong>
|
|
<dd>Retrieves the version information of various objects for
|
|
a file creation property list.
|
|
<dt><strong>Description:</strong>
|
|
<dd><code>H5Pget_version</code> retrieves the version information of various objects
|
|
for a file creation property list. Any pointer parameters which are
|
|
passed as NULL are not queried.
|
|
<dt><strong>Parameters:</strong>
|
|
<dl>
|
|
<dt><em>hid_t</em> <code>plist</code>
|
|
<dd>IN: Identifier of the file creation property list.
|
|
<dt><em>int *</em> <code>super</code>
|
|
<dd>OUT: Pointer to location to return super block version number.
|
|
<dt><em>int *</em> <code>freelist</code>
|
|
<dd>OUT: Pointer to location to return global freelist version number.
|
|
<dt><em>int *</em> <code>stab</code>
|
|
<dd>OUT: Pointer to location to return symbol table version number.
|
|
<dt><em>int *</em> <code>shhdr</code>
|
|
<dd>OUT: Pointer to location to return shared object header version number.
|
|
</dl>
|
|
<dt><strong>Returns:</strong>
|
|
<dd>Returns a non-negative value if successful;
|
|
otherwise returns a negative value.
|
|
<dt><strong>Non-C API(s):</strong>
|
|
<dd><a href="fortran/h5p_FORTRAN.html#h5pget_version_f"
|
|
target="FortranWin"><img src="Graphics/FORTRAN.gif" border=0></a>
|
|
<!--
|
|
<img src="Graphics/Java.gif">
|
|
<img src="Graphics/C++.gif">
|
|
-->
|
|
</dl>
|
|
|
|
|
|
<hr>
|
|
<dl>
|
|
<dt><strong>Name:</strong> <a name="Property-SetUserblock">H5Pset_userblock</a>
|
|
<dt><strong>Signature:</strong>
|
|
<dd><em>herr_t </em><code>H5Pset_userblock</code>(<em>hid_t</em> <code>plist</code>,
|
|
<em>hsize_t</em> <code>size</code>
|
|
)
|
|
<dt><strong>Purpose:</strong>
|
|
<dd>Sets user block size.
|
|
<dt><strong>Description:</strong>
|
|
<dd><code>H5Pset_userblock</code> sets the user block size of a
|
|
file creation property list.
|
|
The default user block size is 0; it may be set to any
|
|
power of 2 equal to 512 or greater (512, 1024, 2048, etc.).
|
|
<dt><strong>Parameters:</strong>
|
|
<dl>
|
|
<dt><em>hid_t</em> <code>plist</code>
|
|
<dd>IN: Identifier of property list to modify.
|
|
<dt><em>hsize_t</em> <code>size</code>
|
|
<dd>IN: Size of the user-block in bytes.
|
|
</dl>
|
|
<dt><strong>Returns:</strong>
|
|
<dd>Returns a non-negative value if successful;
|
|
otherwise returns a negative value.
|
|
<dt><strong>Non-C API(s):</strong>
|
|
<dd><a href="fortran/h5p_FORTRAN.html#h5pset_userblock_f"
|
|
target="FortranWin"><img src="Graphics/FORTRAN.gif" border=0></a>
|
|
<!--
|
|
<img src="Graphics/Java.gif">
|
|
<img src="Graphics/C++.gif">
|
|
-->
|
|
</dl>
|
|
|
|
|
|
<hr>
|
|
<dl>
|
|
<dt><strong>Name:</strong> <a name="Property-GetUserblock">H5Pget_userblock</a>
|
|
<dt><strong>Signature:</strong>
|
|
<dd><em>herr_t </em><code>H5Pget_userblock</code>(<em>hid_t</em> <code>plist</code>,
|
|
<em>hsize_t *</em> <code>size</code>
|
|
)
|
|
<dt><strong>Purpose:</strong>
|
|
<dd>Retrieves the size of a user block.
|
|
<dt><strong>Description:</strong>
|
|
<dd><code>H5Pget_userblock</code> retrieves the size of a user block
|
|
in a file creation property list.
|
|
<dt><strong>Parameters:</strong>
|
|
<dl>
|
|
<dt><em>hid_t</em> <code>plist</code>
|
|
<dd>IN: Identifier for property list to query.
|
|
<dt><em>hsize_t *</em> <code>size</code>
|
|
<dd>OUT: Pointer to location to return user-block size.
|
|
</dl>
|
|
<dt><strong>Returns:</strong>
|
|
<dd>Returns a non-negative value if successful;
|
|
otherwise returns a negative value.
|
|
<dt><strong>Non-C API(s):</strong>
|
|
<dd><a href="fortran/h5p_FORTRAN.html#h5pget_userblock_f"
|
|
target="FortranWin"><img src="Graphics/FORTRAN.gif" border=0></a>
|
|
<!--
|
|
<img src="Graphics/Java.gif">
|
|
<img src="Graphics/C++.gif">
|
|
-->
|
|
</dl>
|
|
|
|
|
|
<hr>
|
|
<dl>
|
|
<dt><strong>Name:</strong> <a name="Property-SetSizes">H5Pset_sizes</a>
|
|
<dt><strong>Signature:</strong>
|
|
<dd><em>herr_t </em><code>H5Pset_sizes</code>(<em>hid_t</em> <code>plist</code>,
|
|
<em>size_t</em> <code>sizeof_addr</code>,
|
|
<em>size_t</em> <code>sizeof_size</code>
|
|
)
|
|
<dt><strong>Purpose:</strong>
|
|
<dd>Sets the byte size of the offsets and lengths used to address objects
|
|
in an HDF5 file.
|
|
<dt><strong>Description:</strong>
|
|
<dd><code>H5Pset_sizes</code> sets the byte size of the offsets and lengths used to
|
|
address objects in an HDF5 file. This function is only valid for
|
|
file creation property lists. Passing in a value of 0 for one of the
|
|
sizeof parameters retains the current value. The default value
|
|
for both values is 4 bytes. Valid values currently are 2, 4, 8 and
|
|
16.
|
|
<dt><strong>Parameters:</strong>
|
|
<dl>
|
|
<dt><em>hid_t</em> <code>plist</code>
|
|
<dd>IN: Identifier of property list to modify.
|
|
<dt><em>size_t</em> <code>sizeof_addr</code>
|
|
<dd>IN: Size of an object offset in bytes.
|
|
<dt><em>size_t</em> <code>sizeof_size</code>
|
|
<dd>IN: Size of an object length in bytes.
|
|
</dl>
|
|
<dt><strong>Returns:</strong>
|
|
<dd>Returns a non-negative value if successful;
|
|
otherwise returns a negative value.
|
|
<dt><strong>Non-C API(s):</strong>
|
|
<dd><a href="fortran/h5p_FORTRAN.html#h5pset_sizes_f"
|
|
target="FortranWin"><img src="Graphics/FORTRAN.gif" border=0></a>
|
|
<!--
|
|
<img src="Graphics/Java.gif">
|
|
<img src="Graphics/C++.gif">
|
|
-->
|
|
</dl>
|
|
|
|
|
|
<hr>
|
|
<dl>
|
|
<dt><strong>Name:</strong> <a name="Property-GetSizes">H5Pget_sizes</a>
|
|
<dt><strong>Signature:</strong>
|
|
<dd><em>herr_t </em><code>H5Pget_sizes</code>(<em>hid_t</em> <code>plist</code>,
|
|
<em>size_t *</em> <code>sizeof_addr</code>,
|
|
<em>size_t *</em> <code>sizeof_size</code>
|
|
)
|
|
<dt><strong>Purpose:</strong>
|
|
<dd>Retrieves the size of the offsets and lengths used in an HDF5 file.
|
|
<dt><strong>Description:</strong>
|
|
<dd><code>H5Pget_sizes</code> retrieves the size of the offsets
|
|
and lengths used in an HDF5 file.
|
|
This function is only valid for file creation property lists.
|
|
<dt><strong>Parameters:</strong>
|
|
<dl>
|
|
<dt><em>hid_t</em> <code>plist</code>
|
|
<dd>IN: Identifier of property list to query.
|
|
<dt><em>size_t *</em> <code>size</code>
|
|
<dd>OUT: Pointer to location to return offset size in bytes.
|
|
<dt><em>size_t *</em> <code>size</code>
|
|
<dd>OUT: Pointer to location to return length size in bytes.
|
|
</dl>
|
|
<dt><strong>Returns:</strong>
|
|
<dd>Returns a non-negative value if successful;
|
|
otherwise returns a negative value.
|
|
<dt><strong>Non-C API(s):</strong>
|
|
<dd><a href="fortran/h5p_FORTRAN.html#h5pget_sizes_f"
|
|
target="FortranWin"><img src="Graphics/FORTRAN.gif" border=0></a>
|
|
<!--
|
|
<img src="Graphics/Java.gif">
|
|
<img src="Graphics/C++.gif">
|
|
-->
|
|
</dl>
|
|
|
|
|
|
<hr>
|
|
<dl>
|
|
<dt><strong>Name:</strong> <a name="Property-SetMPI">H5Pset_mpi</a>
|
|
<dt><strong>Signature:</strong>
|
|
<dd><em>herr_t </em><code>H5Pset_mpi</code>(<em>hid_t</em> <code>plist</code>,
|
|
<em>MPI_Comm</em> <code>comm</code>,
|
|
<em>MPI_Info</em> <code>info</code>
|
|
)
|
|
<dt><strong>Purpose:</strong>
|
|
<dd>Retrieves the access mode for parallel I/O and the user supplied
|
|
communicator and info object.
|
|
<dt><strong>Description:</strong>
|
|
<dd><code>H5Pset_mpi</code> stores the access mode for MPIO call and the user supplied
|
|
communicator and info in the access property list, which can then
|
|
be used to open file. This function is available only in the
|
|
parallel HDF5 library and is not a collective function.
|
|
<dt><strong>Parameters:</strong>
|
|
<dl>
|
|
<dt><em>hid_t</em> <code>plist</code>
|
|
<dd>IN: Identifier of property list to modify.
|
|
<dt><em>MPI_Comm</em> <code>comm</code>
|
|
<dd>IN: MPI communicator to be used for file open as defined in
|
|
MPI_FILE_OPEN of MPI-2. This function does not make a
|
|
duplicated <code>comm</code>. Any modification to <code>comm</code> after
|
|
this function call returns may have undetermined effect
|
|
to the access property list. Users should call this function
|
|
again to setup the property list.
|
|
<dt><em>MPI_Info</em> <code>info</code>
|
|
<dd>IN: MPI info object to be used for file open as defined in
|
|
MPI_FILE_OPEN of MPI-2. This function does not make a
|
|
duplicated <code>info</code>. Any modification to <code>info</code> after
|
|
this function call returns may have undetermined effect
|
|
to the access property list. Users should call this function
|
|
again to setup the property list.
|
|
</dl>
|
|
<dt><strong>Returns:</strong>
|
|
<dd>Returns a non-negative value if successful;
|
|
otherwise returns a negative value.
|
|
<dt><strong>Non-C API(s):</strong>
|
|
<dd><a href="fortran/h5p_FORTRAN.html#h5pset_mpi_f"
|
|
target="FortranWin"><img src="Graphics/FORTRAN.gif" border=0></a>
|
|
<!--
|
|
<img src="Graphics/Java.gif">
|
|
<img src="Graphics/C++.gif">
|
|
-->
|
|
</dl>
|
|
|
|
|
|
<hr>
|
|
<dl>
|
|
<dt><strong>Name:</strong> <a name="Property-GetMPI">H5Pget_mpi</a>
|
|
<dt><strong>Signature:</strong>
|
|
<dd><em>herr_t </em><code>H5Pget_mpi</code>(<em>hid_t</em> <code>plist</code>,
|
|
<em>MPI_Comm</em> <code>*comm</code>,
|
|
<em>MPI_Info</em> <code>*info</code>
|
|
)
|
|
<dt><strong>Purpose:</strong>
|
|
<dd>Retrieves the communicator and info object.
|
|
<dt><strong>Description:</strong>
|
|
<dd><code>H5Pget_mpi</code> retrieves the communicator and info object
|
|
that have been set by H5Pset_mpi.
|
|
This function is available only in the parallel HDF5 library
|
|
and is not a collective function.
|
|
<dt><strong>Parameters:</strong>
|
|
<dl>
|
|
<dt><em>hid_t</em> <code>plist</code>
|
|
<dd>IN: Identifier of a file access property list that has been set
|
|
successfully by H5Pset_mpi.
|
|
<dt><em>MPI_Comm *</em> <code>comm</code>
|
|
<dd>OUT: Pointer to location to return the communicator.
|
|
<dt><em>MPI_Info *</em> <code>info</code>
|
|
<dd>OUT: Pointer to location to return the info object.
|
|
</dl>
|
|
<dt><strong>Returns:</strong>
|
|
<dd>Returns a non-negative value if the file access property list is set to the MPI.
|
|
Otherwise returns a negative value.
|
|
<dt><strong>Non-C API(s):</strong>
|
|
<dd><a href="fortran/h5p_FORTRAN.html#h5pget_mpi_f"
|
|
target="FortranWin"><img src="Graphics/FORTRAN.gif" border=0></a>
|
|
<!--
|
|
<img src="Graphics/Java.gif">
|
|
<img src="Graphics/C++.gif">
|
|
-->
|
|
</dl>
|
|
|
|
|
|
<hr>
|
|
<dl>
|
|
<dt><strong>Name:</strong> <a name="Property-SetXfer">H5Pset_xfer</a>
|
|
<dt><strong>Signature:</strong>
|
|
<dd><em>herr_t </em><code>H5Pset_xfer</code>(<em>hid_t</em> <code>plist</code>,
|
|
<em>H5D_transfer_t</em> <code>data_xfer_mode</code>
|
|
)
|
|
<dt><strong>Purpose:</strong>
|
|
<dd>Sets the transfer mode of the dataset transfer property list.
|
|
<dt><strong>Description:</strong>
|
|
<dd><code>H5Pset_xfer</code> sets the transfer mode of the dataset transfer property list.
|
|
The list can then be used to control the I/O transfer mode
|
|
during dataset accesses. This function is available only
|
|
in the parallel HDF5 library and is not a collective function.
|
|
<p>
|
|
Valid data transfer modes are:
|
|
<ul><dl>
|
|
<dt>H5D_XFER_INDEPENDENT
|
|
<dd>Use independent I/O access.
|
|
(Currently the default mode.)
|
|
<dt>H5D_XFER_COLLECTIVE
|
|
<dd>Use MPI collective I/O access.
|
|
<dt>H5D_XFER_DFLT
|
|
<dd>User default I/O access.
|
|
</dl></ul>
|
|
<dt><strong>Parameters:</strong>
|
|
<dl>
|
|
<dt><em>hid_t</em> <code>plist</code>
|
|
<dd>IN: Identifier of a dataset transfer property list
|
|
<dt><em>H5D_transfer_t</em> <code>data_xfer_mode</code>
|
|
<dd>IN: Data transfer mode.
|
|
</dl>
|
|
<dt><strong>Returns:</strong>
|
|
<dd>Returns a non-negative value if successful;
|
|
otherwise returns a negative value.
|
|
<dt><strong>Non-C API(s):</strong>
|
|
<dd><a href="fortran/h5p_FORTRAN.html#h5pset_xfer_f"
|
|
target="FortranWin"><img src="Graphics/FORTRAN.gif" border=0></a>
|
|
<!--
|
|
<img src="Graphics/Java.gif">
|
|
<img src="Graphics/C++.gif">
|
|
-->
|
|
</dl>
|
|
|
|
|
|
<hr>
|
|
<dl>
|
|
<dt><strong>Name:</strong> <a name="Property-GetXfer">H5Pget_xfer</a>
|
|
<dt><strong>Signature:</strong>
|
|
<dd><em>herr_t </em><code>H5Pget_xfer</code>(<em>hid_t</em> <code>plist</code>,
|
|
<em>H5D_transfer_t *</em> <code>data_xfer_mode</code>
|
|
)
|
|
<dt><strong>Purpose:</strong>
|
|
<dd>Retrieves the transfer mode from the dataset transfer property list.
|
|
<dt><strong>Description:</strong>
|
|
<dd><code>H5Pget_xfer</code> retrieves the transfer mode from the
|
|
dataset transfer property list.
|
|
This function is available only in the parallel HDF5 library
|
|
and is not a collective function.
|
|
<dt><strong>Parameters:</strong>
|
|
<dl>
|
|
<dt><em>hid_t</em> <code>plist</code>
|
|
<dd>IN: Identifier of a dataset transfer property list.
|
|
<dt><em>H5D_transfer_t *</em> <code>data_xfer_mode</code>
|
|
<dd>OUT: Pointer to location to return the data transfer mode.
|
|
</dl>
|
|
<dt><strong>Returns:</strong>
|
|
<dd>Returns a non-negative value if successful;
|
|
otherwise returns a negative value.
|
|
<dt><strong>Non-C API(s):</strong>
|
|
<dd><a href="fortran/h5p_FORTRAN.html#h5pget_xfer_f"
|
|
target="FortranWin"><img src="Graphics/FORTRAN.gif" border=0></a>
|
|
<!--
|
|
<img src="Graphics/Java.gif">
|
|
<img src="Graphics/C++.gif">
|
|
-->
|
|
</dl>
|
|
|
|
|
|
<hr>
|
|
<dl>
|
|
<dt><strong>Name:</strong> <a name="Property-SetSymK">H5Pset_sym_k</a>
|
|
<dt><strong>Signature:</strong>
|
|
<dd><em>herr_t </em><code>H5Pset_sym_k</code>(<em>hid_t</em> <code>plist</code>,
|
|
<em>int</em> <code>ik</code>,
|
|
<em>int</em> <code>lk</code>
|
|
)
|
|
<dt><strong>Purpose:</strong>
|
|
<dd>Sets the size of parameters used to control the symbol table nodes.
|
|
<dt><strong>Description:</strong>
|
|
<dd><code>H5Pset_sym_k</code> sets the size of parameters used to
|
|
control the symbol table nodes. This function is only valid
|
|
for file creation property lists. Passing in a value of 0 for
|
|
one of the parameters retains the current value.
|
|
<p>
|
|
<code>ik</code> is one half the rank of a tree that stores a symbol
|
|
table for a group. Internal nodes of the symbol table are on
|
|
average 75% full. That is, the average rank of the tree is
|
|
1.5 times the value of <code>ik</code>.
|
|
<p>
|
|
<code>lk</code> is one half of the number of symbols that can
|
|
be stored in a symbol table node. A symbol table node is the
|
|
leaf of a symbol table tree which is used to store a group.
|
|
When symbols are inserted randomly into a group, the group's
|
|
symbol table nodes are 75% full on average. That is, they
|
|
contain 1.5 times the number of symbols specified by
|
|
<code>lk</code>.
|
|
<dt><strong>Parameters:</strong>
|
|
<dl>
|
|
<dt><em>hid_t</em> <code>plist</code>
|
|
<dd>IN: Identifier for property list to query.
|
|
<dt><em>int</em> <code>ik</code>
|
|
<dd>IN: Symbol table tree rank.
|
|
<dt><em>int</em> <code>lk</code>
|
|
<dd>IN: Symbol table node size.
|
|
</dl>
|
|
<dt><strong>Returns:</strong>
|
|
<dd>Returns a non-negative value if successful;
|
|
otherwise returns a negative value.
|
|
<dt><strong>Non-C API(s):</strong>
|
|
<dd><a href="fortran/h5p_FORTRAN.html#h5pset_sym_k_f"
|
|
target="FortranWin"><img src="Graphics/FORTRAN.gif" border=0></a>
|
|
<!--
|
|
<img src="Graphics/Java.gif">
|
|
<img src="Graphics/C++.gif">
|
|
-->
|
|
</dl>
|
|
|
|
|
|
<hr>
|
|
<dl>
|
|
<dt><strong>Name:</strong> <a name="Property-GetSymK">H5Pget_sym_k</a>
|
|
<dt><strong>Signature:</strong>
|
|
<dd><em>herr_t </em><code>H5Pget_sym_k</code>(<em>hid_t</em> <code>plist</code>,
|
|
<em>int *</em> <code>ik</code>,
|
|
<em>int *</em> <code>lk</code>
|
|
)
|
|
<dt><strong>Purpose:</strong>
|
|
<dd>Retrieves the size of the symbol table B-tree 1/2 rank
|
|
and the symbol table leaf node 1/2 size.
|
|
<dt><strong>Description:</strong>
|
|
<dd><code>H5Pget_sym_k</code> retrieves the size of the
|
|
symbol table B-tree 1/2 rank and the symbol table leaf
|
|
node 1/2 size. This function is only valid for file creation
|
|
property lists. If a parameter valued is set to NULL, that
|
|
parameter is not retrieved. See the description for
|
|
<a href="#Property-SetSymK">H5Pset_sym_k</a> for more
|
|
information.
|
|
<dt><strong>Parameters:</strong>
|
|
<dl>
|
|
<dt><em>hid_t</em> <code>plist</code>
|
|
<dd>IN: Property list to query.
|
|
<dt><em>int *</em> <code>ik</code>
|
|
<dd>OUT: Pointer to location to return the symbol table's B-tree 1/2 rank.
|
|
<dt><em>int *</em> <code>size</code>
|
|
<dd>OUT: Pointer to location to return the symbol table's leaf node 1/2 size.
|
|
</dl>
|
|
<dt><strong>Returns:</strong>
|
|
<dd>Returns a non-negative value if successful;
|
|
otherwise returns a negative value.
|
|
<dt><strong>Non-C API(s):</strong>
|
|
<dd><a href="fortran/h5p_FORTRAN.html#h5pget_sym_k_f"
|
|
target="FortranWin"><img src="Graphics/FORTRAN.gif" border=0></a>
|
|
<!--
|
|
<img src="Graphics/Java.gif">
|
|
<img src="Graphics/C++.gif">
|
|
-->
|
|
</dl>
|
|
|
|
|
|
<hr>
|
|
<dl>
|
|
<dt><strong>Name:</strong> <a name="Property-SetIstoreK">H5Pset_istore_k</a>
|
|
<dt><strong>Signature:</strong>
|
|
<dd><em>herr_t </em><code>H5Pset_istore_k</code>(<em>hid_t</em> <code>plist</code>,
|
|
<em>int</em> <code>ik</code>
|
|
)
|
|
<dt><strong>Purpose:</strong>
|
|
<dd>Sets the size of the parameter used to control the
|
|
B-trees for indexing chunked datasets.
|
|
<dt><strong>Description:</strong>
|
|
<dd><code>H5Pset_istore_k</code> sets the size of the parameter
|
|
used to control the B-trees for indexing chunked datasets.
|
|
This function is only valid for file creation property lists.
|
|
Passing in a value of 0 for one of the parameters retains
|
|
the current value.
|
|
<p>
|
|
<code>ik</code> is one half the rank of a tree that stores
|
|
chunked raw data. On average, such a tree will be 75% full,
|
|
or have an average rank of 1.5 times the value of
|
|
<code>ik</code>.
|
|
<dt><strong>Parameters:</strong>
|
|
<dl>
|
|
<dt><em>hid_t</em> <code>plist</code>
|
|
<dd>IN: Identifier of property list to query.
|
|
<dt><em>int</em> <code>ik</code>
|
|
<dd>IN: 1/2 rank of chunked storage B-tree.
|
|
</dl>
|
|
<dt><strong>Returns:</strong>
|
|
<dd>Returns a non-negative value if successful;
|
|
otherwise returns a negative value.
|
|
<dt><strong>Non-C API(s):</strong>
|
|
<dd><a href="fortran/h5p_FORTRAN.html#h5pset_istore_k_f"
|
|
target="FortranWin"><img src="Graphics/FORTRAN.gif" border=0></a>
|
|
<!--
|
|
<img src="Graphics/Java.gif">
|
|
<img src="Graphics/C++.gif">
|
|
-->
|
|
</dl>
|
|
|
|
|
|
<hr>
|
|
<dl>
|
|
<dt><strong>Name:</strong> <a name="Property-GetIstoreK">H5Pget_istore_k</a>
|
|
<dt><strong>Signature:</strong>
|
|
<dd><em>herr_t </em><code>H5Pget_istore_k</code>(<em>hid_t</em> <code>plist</code>,
|
|
<em>int *</em> <code>ik</code>
|
|
)
|
|
<dt><strong>Purpose:</strong>
|
|
<dd>Queries the 1/2 rank of an indexed storage B-tree.
|
|
<dt><strong>Description:</strong>
|
|
<dd><code>H5Pget_istore_k</code> queries the 1/2 rank of
|
|
an indexed storage B-tree.
|
|
The argument <code>ik</code> may be the null pointer (NULL).
|
|
This function is only valid for file creation property lists.
|
|
<p>
|
|
See <a href="#Property-SetIstoreK">H5Pset_istore_k</a> for details.
|
|
<dt><strong>Parameters:</strong>
|
|
<dl>
|
|
<dt><em>hid_t</em> <code>plist</code>
|
|
<dd>IN: Identifier of property list to query.
|
|
<dt><em>int *</em> <code>ik</code>
|
|
<dd>OUT: Pointer to location to return the chunked storage B-tree 1/2 rank.
|
|
</dl>
|
|
<dt><strong>Returns:</strong>
|
|
<dd>Returns a non-negative value if successful;
|
|
otherwise returns a negative value.
|
|
<dt><strong>Non-C API(s):</strong>
|
|
<dd><a href="fortran/h5p_FORTRAN.html#h5pget_istore_k_f"
|
|
target="FortranWin"><img src="Graphics/FORTRAN.gif" border=0></a>
|
|
<!--
|
|
<img src="Graphics/Java.gif">
|
|
<img src="Graphics/C++.gif">
|
|
-->
|
|
</dl>
|
|
|
|
|
|
<hr>
|
|
<dl>
|
|
<dt><strong>Name:</strong> <a name="Property-SetLayout">H5Pset_layout</a>
|
|
<dt><strong>Signature:</strong>
|
|
<dd><em>herr_t </em><code>H5Pset_layout</code>(<em>hid_t</em> <code>plist</code>,
|
|
<em>H5D_layout_t</em> <code>layout</code>
|
|
)
|
|
<dt><strong>Purpose:</strong>
|
|
<dd>Sets the type of storage used store the raw data for a dataset.
|
|
<dt><strong>Description:</strong>
|
|
<dd><code>H5Pset_layout</code> sets the type of storage used store the
|
|
raw data for a dataset.
|
|
This function is only valid for dataset creation property lists.
|
|
Valid parameters for <code>layout</code> are:
|
|
<ul><dl>
|
|
<dt>H5D_COMPACT <i><b>(Not yet implemented.)</b></i>
|
|
<dd>Store raw data and object header contiguously in file.
|
|
This should only be used for very small amounts of raw
|
|
data (suggested less than 1KB).
|
|
<dt>H5D_CONTIGUOUS
|
|
<dd>Store raw data separately from object header in one
|
|
large chunk in the file.
|
|
<dt>H5D_CHUNKED
|
|
<dd>Store raw data separately from object header in one
|
|
large chunk in the file and store chunks of the raw
|
|
data in separate locations in the file.
|
|
</dl></ul>
|
|
<dt><strong>Parameters:</strong>
|
|
<dl>
|
|
<dt><em>hid_t</em> <code>plist</code>
|
|
<dd>IN: Identifier of property list to query.
|
|
<dt><em>H5D_layout_t</em> <code>layout</code>
|
|
<dd>IN: Type of storage layout for raw data.
|
|
</dl>
|
|
<dt><strong>Returns:</strong>
|
|
<dd>Returns a non-negative value if successful;
|
|
otherwise returns a negative value.
|
|
<dt><strong>Non-C API(s):</strong>
|
|
<dd><a href="fortran/h5p_FORTRAN.html#h5pset_layout_f"
|
|
target="FortranWin"><img src="Graphics/FORTRAN.gif" border=0></a>
|
|
<!--
|
|
<img src="Graphics/Java.gif">
|
|
<img src="Graphics/C++.gif">
|
|
-->
|
|
</dl>
|
|
|
|
|
|
<hr>
|
|
<dl>
|
|
<dt><strong>Name:</strong> <a name="Property-GetLayout">H5Pget_layout</a>
|
|
<dt><strong>Signature:</strong>
|
|
<dd><em>H5D_layout_t</em> <code>H5Pget_layout</code>(<em>hid_t</em> <code>plist</code>)
|
|
<dt><strong>Purpose:</strong>
|
|
<dd>Returns the layout of the raw data for a dataset.
|
|
<dt><strong>Description:</strong>
|
|
<dd><code>H5Pget_layout</code> returns the layout of the raw data for
|
|
a dataset. This function is only valid for dataset creation
|
|
property lists. Valid types for <code>layout</code> are:
|
|
<ul> <dl>
|
|
<dt>H5D_COMPACT <i><b>(Not yet implemented.)</b></i>
|
|
<dd>Raw data and object header stored contiguously in file.
|
|
<dt>H5D_CONTIGUOUS
|
|
<dd>Raw data stored separately from object header in one
|
|
large chunk in the file.
|
|
<dt>H5D_CHUNKED
|
|
<dd>Raw data stored separately from object header in
|
|
chunks in separate locations in the file.
|
|
</dl> </ul>
|
|
<dt><strong>Parameters:</strong>
|
|
<dl>
|
|
<dt><em>hid_t</em> <code>plist</code>
|
|
<dd>IN: Identifier for property list to query.
|
|
</dl>
|
|
<dt><strong>Returns:</strong>
|
|
<dd>Returns the layout type of a a dataset creation property list
|
|
if successful.
|
|
Otherwise returns H5D_LAYOUT_ERROR (-1).
|
|
<dt><strong>Non-C API(s):</strong>
|
|
<dd><a href="fortran/h5p_FORTRAN.html#h5pget_layout_f"
|
|
target="FortranWin"><img src="Graphics/FORTRAN.gif" border=0></a>
|
|
<!--
|
|
<img src="Graphics/Java.gif">
|
|
<img src="Graphics/C++.gif">
|
|
-->
|
|
</dl>
|
|
|
|
|
|
<hr>
|
|
<dl>
|
|
<dt><strong>Name:</strong> <a name="Property-SetChunk">H5Pset_chunk</a>
|
|
<dt><strong>Signature:</strong>
|
|
<dd><em>herr_t </em><code>H5Pset_chunk</code>(<em>hid_t</em> <code>plist</code>,
|
|
<em>int</em> <code>ndims</code>,
|
|
<em>const hsize_t *</em> <code>dim</code>
|
|
)
|
|
<dt><strong>Purpose:</strong>
|
|
<dd>Sets the size of the chunks used to store a chunked layout dataset.
|
|
<dt><strong>Description:</strong>
|
|
<dd><code>H5Pset_chunk</code> sets the size of the chunks used to
|
|
store a chunked layout dataset. This function is only valid
|
|
for dataset creation property lists.
|
|
The <code>ndims</code> parameter currently must be the same size
|
|
as the rank of the dataset. The values of the <code>dim</code>
|
|
array define the size of the chunks to store the dataset's raw data.
|
|
As a side-effect, the layout of the dataset is changed to
|
|
<code>H5D_CHUNKED</code>, if it is not already.
|
|
<dt><strong>Parameters:</strong>
|
|
<dl>
|
|
<dt><em>hid_t</em> <code>plist</code>
|
|
<dd>IN: Identifier for property list to query.
|
|
<dt><em>int</em> <code>ndims</code>
|
|
<dd>IN: The number of dimensions of each chunk.
|
|
<dt><em>const hsize_t *</em> <code>dim</code>
|
|
<dd>IN: An array containing the size of each chunk.
|
|
</dl>
|
|
<dt><strong>Returns:</strong>
|
|
<dd>Returns a non-negative value if successful;
|
|
otherwise returns a negative value.
|
|
<dt><strong>Non-C API(s):</strong>
|
|
<dd><a href="fortran/h5p_FORTRAN.html#h5pset_chunk_f"
|
|
target="FortranWin"><img src="Graphics/FORTRAN.gif" border=0></a>
|
|
<!--
|
|
<img src="Graphics/Java.gif">
|
|
<img src="Graphics/C++.gif">
|
|
-->
|
|
</dl>
|
|
|
|
|
|
<hr>
|
|
<dl>
|
|
<dt><strong>Name:</strong> <a name="Property-GetChunk">H5Pget_chunk</a>
|
|
<dt><strong>Signature:</strong>
|
|
<dd><em>int </em><code>H5Pget_chunk</code>(<em>hid_t</em> <code>plist</code>,
|
|
<em>int</em> <code>max_ndims</code>,
|
|
<em>hsize_t *</em> <code>dims</code>
|
|
)
|
|
<dt><strong>Purpose:</strong>
|
|
<dd>Retrieves the size of chunks for the raw data of a chunked layout dataset.
|
|
|
|
<dt><strong>Description:</strong>
|
|
<dd><code>H5Pget_chunk</code> retrieves the size of chunks for the
|
|
raw data of a chunked layout dataset.
|
|
This function is only valid for dataset creation property lists.
|
|
At most, <code>max_ndims</code> elements of <code>dims</code>
|
|
will be initialized.
|
|
<dt><strong>Parameters:</strong>
|
|
<dl>
|
|
<dt><em>hid_t</em> <code>plist</code>
|
|
<dd>IN: Identifier of property list to query.
|
|
<dt><em>int</em> <code>max_ndims</code>
|
|
<dd>IN: Size of the <code>dims</code> array.
|
|
<dt><em>hsize_t *</em> <code>dims</code>
|
|
<dd>OUT: Array to store the chunk dimensions.
|
|
</dl>
|
|
<dt><strong>Returns:</strong>
|
|
<dd>Returns chunk dimensionality successful;
|
|
otherwise returns a negative value.
|
|
<dt><strong>Non-C API(s):</strong>
|
|
<dd><a href="fortran/h5p_FORTRAN.html#h5pget_chunk_f"
|
|
target="FortranWin"><img src="Graphics/FORTRAN.gif" border=0></a>
|
|
<!--
|
|
<img src="Graphics/Java.gif">
|
|
<img src="Graphics/C++.gif">
|
|
-->
|
|
</dl>
|
|
|
|
|
|
<hr>
|
|
<dl>
|
|
<dt><strong>Name:</strong> <a name="Property-SetAlignment">H5Pset_alignment</a>
|
|
<dt><strong>Signature:</strong>
|
|
<dd><em>herr_t</em> <code>H5Pset_alignment</code>(<em>hid_t</em> <code>plist</code>,
|
|
<em>hsize_t</em> <code>threshold</code>,
|
|
<em>hsize_t</em> <code>alignment</code>
|
|
)
|
|
<dt><strong>Purpose:</strong>
|
|
<dd>Sets alignment properties of a file access property list.
|
|
<dt><strong>Description:</strong>
|
|
<dd><code>H5Pset_alignment</code> sets the alignment properties
|
|
of a file access property list
|
|
so that any file object greater than or equal in size to
|
|
<code>threshold</code> bytes will be aligned on an address
|
|
which is a multiple of <code>alignment</code>. The addresses
|
|
are relative to the end of the user block; the alignment is
|
|
calculated by subtracting the user block size from the
|
|
absolute file address and then adjusting the address to be a
|
|
multiple of <code>alignment</code>.
|
|
<p>
|
|
Default values for <code>threshold</code> and
|
|
<code>alignment</code> are one, implying
|
|
no alignment. Generally the default values will result in
|
|
the best performance for single-process access to the file.
|
|
For MPI-IO and other parallel systems, choose an alignment
|
|
which is a multiple of the disk block size.
|
|
<dt><strong>Parameters:</strong>
|
|
<dl>
|
|
<dt><em>hid_t</em> <code>plist</code>
|
|
<dd>IN: Identifier for a file access property list.
|
|
<dt><em>hsize_t</em> <code>threshold</code>
|
|
<dd>IN: Threshold value.
|
|
Must be non-negative.
|
|
Note that setting the threshold value to 0 (zero) has
|
|
the effect of a special case, forcing everything
|
|
to be aligned.
|
|
<dt><em>hsize_t</em> <code>alignment</code>
|
|
<dd>IN: Alignment value.
|
|
Must be a positive value.
|
|
</dl>
|
|
<dt><strong>Returns:</strong>
|
|
<dd>Returns a non-negative value if successful;
|
|
otherwise returns a negative value.
|
|
<dt><strong>Non-C API(s):</strong>
|
|
<dd><a href="fortran/h5p_FORTRAN.html#h5pset_alignment_f"
|
|
target="FortranWin"><img src="Graphics/FORTRAN.gif" border=0></a>
|
|
<!--
|
|
<img src="Graphics/Java.gif">
|
|
<img src="Graphics/C++.gif">
|
|
-->
|
|
</dl>
|
|
|
|
|
|
<hr>
|
|
<dl>
|
|
<dt><strong>Name:</strong> <a name="Property-GetAlignment">H5Pget_alignment</a>
|
|
<dt><strong>Signature:</strong>
|
|
<dd><em>herr_t</em> <code>H5Pget_alignment</code>(<em>hid_t</em> <code>plist</code>,
|
|
<em>hsize_t</em> <code>*threshold</code>,
|
|
<em>hsize_t</em> <code>*alignment</code>
|
|
)
|
|
<dt><strong>Purpose:</strong>
|
|
<dd>Retrieves the current settings for alignment properties from a
|
|
file access property list.
|
|
<dt><strong>Description:</strong>
|
|
<dd><code>H5Pget_alignment</code> retrieves the current settings for
|
|
alignment properties from a file access property list.
|
|
The <code>threshold</code> and/or <code>alignment</code> pointers
|
|
may be null pointers (NULL).
|
|
<dt><strong>Parameters:</strong>
|
|
<dl>
|
|
<dt><em>hid_t</em> <code>plist</code>
|
|
<dd>IN: Identifier of a file access property list.
|
|
<dt><em>hsize_t</em> <code>*threshold</code>
|
|
<dd>OUT: Pointer to location of return threshold value.
|
|
<dt><em>hsize_t</em> <code>*alignment</code>
|
|
<dd>OUT: Pointer to location of return alignment value.
|
|
</dl>
|
|
<dt><strong>Returns:</strong>
|
|
<dd>Returns a non-negative value if successful;
|
|
otherwise returns a negative value.
|
|
<dt><strong>Non-C API(s):</strong>
|
|
<dd><a href="fortran/h5p_FORTRAN.html#h5pget_alignment_f"
|
|
target="FortranWin"><img src="Graphics/FORTRAN.gif" border=0></a>
|
|
<!--
|
|
<img src="Graphics/Java.gif">
|
|
<img src="Graphics/C++.gif">
|
|
-->
|
|
</dl>
|
|
|
|
|
|
<hr>
|
|
<dl>
|
|
<dt><strong>Name:</strong> <a name="Property-SetExternal">H5Pset_external</a>
|
|
<dt><strong>Signature:</strong>
|
|
<dd><em>herr_t</em> <code>H5Pset_external</code>(<em>hid_t</em> <code>plist</code>,
|
|
<em>const char</em> <code>*name</code>,
|
|
<em>off_t</em> <code>offset</code>,
|
|
<em>hsize_t</em> <code>size</code>
|
|
)
|
|
<dt><strong>Purpose:</strong>
|
|
<dd>Adds an external file to the list of external files.
|
|
<dt><strong>Description:</strong>
|
|
<dd><code>H5Pset_external</code> adds an external file to the
|
|
list of external files.
|
|
<p>
|
|
If a dataset is split across multiple files then the files
|
|
should be defined in order. The total size of the dataset is
|
|
the sum of the <code>size</code> arguments for all the external files. If
|
|
the total size is larger than the size of a dataset then the
|
|
dataset can be extended (provided the data space also allows
|
|
the extending).
|
|
<p>
|
|
The <code>size</code> argument specifies number of bytes reserved
|
|
for data in the external file.
|
|
If <code>size</code> is set to <code>H5F_UNLIMITED</code>, the
|
|
external file can be of unlimited size and no more files can be added to
|
|
the external files list.
|
|
<dt><strong>Parameters:</strong>
|
|
<dl>
|
|
<dt><em>hid_t</em> <code>plist</code>
|
|
<dd>IN: Identifier of a dataset creation property list.
|
|
<dt><em>const char</em> <code>*name</code>
|
|
<dd>IN: Name of an external file.
|
|
<dt><em>off_t</em> <code>offset</code>
|
|
<dd>IN: Offset, in bytes, from the beginning of the file
|
|
to the location in the file where the data starts.
|
|
<dt><em>hsize_t</em> <code>size</code>
|
|
<dd>IN: Number of bytes reserved in the file for the data.
|
|
</dl>
|
|
<dt><strong>Returns:</strong>
|
|
<dd>Returns a non-negative value if successful;
|
|
otherwise returns a negative value.
|
|
<dt><strong>Non-C API(s):</strong>
|
|
<dd><a href="fortran/h5p_FORTRAN.html#h5pset_external_f"
|
|
target="FortranWin"><img src="Graphics/FORTRAN.gif" border=0></a>
|
|
<!--
|
|
<img src="Graphics/Java.gif">
|
|
<img src="Graphics/C++.gif">
|
|
-->
|
|
</dl>
|
|
|
|
|
|
<hr>
|
|
<dl>
|
|
<dt><strong>Name:</strong> <a name="Property-GetExternalCount">H5Pget_external_count</a>
|
|
<dt><strong>Signature:</strong>
|
|
<dd><em>int</em> <code>H5Pget_external_count</code>(<em>hid_t</em> <code>plist</code>
|
|
)
|
|
<dt><strong>Purpose:</strong>
|
|
<dd>Returns the number of external files for a dataset.
|
|
<dt><strong>Description:</strong>
|
|
<dd><code>H5Pget_external_count</code> returns the number of external files
|
|
for the specified dataset.
|
|
<dt><strong>Parameters:</strong>
|
|
<dl>
|
|
<dt><em>hid_t</em> <code>plist</code>
|
|
<dd>IN: Identifier of a dataset creation property list.
|
|
</dl>
|
|
<dt><strong>Returns:</strong>
|
|
<dd>Returns the number of external files if successful;
|
|
otherwise returns a negative value.
|
|
<dt><strong>Non-C API(s):</strong>
|
|
<dd><a href="fortran/h5p_FORTRAN.html#h5pget_external_count_f"
|
|
target="FortranWin"><img src="Graphics/FORTRAN.gif" border=0></a>
|
|
<!--
|
|
<img src="Graphics/Java.gif">
|
|
<img src="Graphics/C++.gif">
|
|
-->
|
|
</dl>
|
|
|
|
|
|
<hr>
|
|
<dl>
|
|
<dt><strong>Name:</strong> <a name="Property-GetExternal">H5Pget_external</a>
|
|
<dt><strong>Signature:</strong>
|
|
<dd><em>herr_t</em> <code>H5Pget_external</code>(<em>hid_t</em> <code>plist</code>,
|
|
<em>int</em> <code>idx</code>,
|
|
<em>size_t</em> <code>name_size</code>,
|
|
<em>char</em> <code>*name</code>,
|
|
<em>off_t</em> <code>*offset</code>,
|
|
<em>hsize_t</em> <code>*size</code>
|
|
)
|
|
<dt><strong>Purpose:</strong>
|
|
<dd>Returns information about an external file.
|
|
<dt><strong>Description:</strong>
|
|
<dd><code>H5Pget_external</code> returns information about an external
|
|
file. The external file is specified by its index, <code>idx</code>,
|
|
which is a number from zero to N-1, where N is the value
|
|
returned by <code>H5Pget_external_count()</code>.
|
|
At most <code>name_size</code> characters are copied into the
|
|
<code>name</code> array. If the external file name is
|
|
longer than <code>name_size</code> with the null terminator, the
|
|
return value is not null terminated (similar to <code>strncpy()</code>).
|
|
<p>
|
|
If <code>name_size</code> is zero or <code>name</code> is the
|
|
null pointer, the external file name is not returned.
|
|
If <code>offset</code> or <code>size</code> are null pointers
|
|
then the corresponding information is not returned.
|
|
<dt><strong>Parameters:</strong>
|
|
<dl>
|
|
<dt><em>hid_t</em> <code>plist</code>
|
|
<dd>IN: Identifier of a dataset creation property list.
|
|
<dt><em>int</em> <code>idx</code>
|
|
<dd>IN: External file index.
|
|
<dt><em>size_t</em> <code>name_size</code>
|
|
<dd>IN: Maximum length of <code>name</code> array.
|
|
<dt><em>char</em> <code>*name</code>
|
|
<dd>OUT: Name of the external file.
|
|
<dt><em>off_t</em> <code>*offset</code>
|
|
<dd>OUT: Pointer to a location to return an offset value.
|
|
<dt><em>hsize_t</em> <code>*size</code>
|
|
<dd>OUT: Pointer to a location to return the size of the
|
|
external file data.
|
|
</dl>
|
|
<dt><strong>Returns:</strong>
|
|
<dd>Returns a non-negative value if successful;
|
|
otherwise returns a negative value.
|
|
<dt><strong>Non-C API(s):</strong>
|
|
<dd><a href="fortran/h5p_FORTRAN.html#h5pget_external_f"
|
|
target="FortranWin"><img src="Graphics/FORTRAN.gif" border=0></a>
|
|
<!--
|
|
<img src="Graphics/Java.gif">
|
|
<img src="Graphics/C++.gif">
|
|
-->
|
|
</dl>
|
|
|
|
<hr>
|
|
<dl>
|
|
<dt><strong>Name:</strong> <a name="Property-SetFillValue">H5Pset_fill_value</a>
|
|
<dt><strong>Signature:</strong>
|
|
<dd><em>herr_t</em> <code>H5Pset_fill_value</code>(<em>hid_t</em> <code>plist_id</code>,
|
|
<em>hid_t</em> <code>type_id</code>,
|
|
<em>const void *</em><code>value</code>
|
|
)
|
|
<dt><strong>Purpose:</strong>
|
|
<dd>Sets a dataset fill value.
|
|
<dt><strong>Description:</strong>
|
|
<dd><code>H5Pset_fill_value</code> sets the fill value for a
|
|
dataset creation property list.
|
|
<p>
|
|
The <code>value</code> is interpreted as being of type
|
|
<code>type_id</code>. This need not be the same type
|
|
as the dataset, but the library must be able to convert
|
|
<code>value</code> to the dataset type when the dataset
|
|
is created.
|
|
<dt><strong>Notes:</strong>
|
|
<dd>If a fill value is set for a dataset (even if the
|
|
fill value is all zeros), the fill value will be written
|
|
to the file. If no fill value is set, then HDF5 relies on
|
|
the underlying file driver (usually a Unix file system)
|
|
to initialize unwritten parts of the file to zeros.
|
|
<p>
|
|
Creating a contiguous dataset with a fill value can be a
|
|
very expensive operation since the optimization has not
|
|
yet been implemented that would delay the writing of the
|
|
fill values until after some data has been written.
|
|
<dt><strong>Parameters:</strong>
|
|
<dl>
|
|
<dt><em>hid_t</em> <code>plist_id</code>
|
|
<dd>IN: Property list identifier.
|
|
<dt><em>hid_t</em> <code>type_id</code>,
|
|
<dd>IN: The datatype identifier of <code>value</code>.
|
|
<dt><em>const void *</em><code>value</code>
|
|
<dd>IN: The fill value.
|
|
</dl>
|
|
<dt><strong>Returns:</strong>
|
|
<dd>Returns a non-negative value if successful;
|
|
otherwise returns a negative value.
|
|
<dt><strong>Non-C API(s):</strong>
|
|
<dd><a href="fortran/h5p_FORTRAN.html#h5pset_fill_value_f"
|
|
target="FortranWin"><img src="Graphics/FORTRAN.gif" border=0></a>
|
|
<!--
|
|
<img src="Graphics/Java.gif">
|
|
<img src="Graphics/C++.gif">
|
|
-->
|
|
</dl>
|
|
|
|
|
|
<hr>
|
|
<dl>
|
|
<dt><strong>Name:</strong> <a name="Property-GetFillValue">H5Pget_fill_value</a>
|
|
<dt><strong>Signature:</strong>
|
|
<dd><em>herr_t</em> <code>H5Pget_fill_value</code>(<em>hid_t</em> <code>plist_id</code>,
|
|
<em>hid_t</em> <code>type_id</code>,
|
|
<em>void *</em><code>value</code>
|
|
)
|
|
<dt><strong>Purpose:</strong>
|
|
<dd>Retrieves a dataset fill value.
|
|
<dt><strong>Description:</strong>
|
|
<dd><code>H5Pget_fill_value</code> queries the
|
|
fill value property of a dataset creation property list.
|
|
<p>
|
|
The fill value is returned through the <code>value</code>
|
|
pointer.
|
|
<p>
|
|
Memory is allocated by the caller.
|
|
<p>
|
|
The fill value will be converted from its current
|
|
data type to the type specified by <code>type_id</code>.
|
|
<dt><strong>Parameters:</strong>
|
|
<dl>
|
|
<dt><em>hid_t</em> <code>plist_id</code>
|
|
<dd>IN: Property list identifier.
|
|
<dt><em>hid_t</em> <code>type_id</code>,
|
|
<dd>IN: The datatype identifier of <code>value</code>.
|
|
<dt><em>const void *</em><code>value</code>
|
|
<dd>IN: The fill value.
|
|
</dl>
|
|
<dt><strong>Returns:</strong>
|
|
<dd>Returns a non-negative value if successful;
|
|
otherwise returns a negative value.
|
|
<dt><strong>Non-C API(s):</strong>
|
|
<dd><a href="fortran/h5p_FORTRAN.html#h5pget_fill_value_f"
|
|
target="FortranWin"><img src="Graphics/FORTRAN.gif" border=0></a>
|
|
<!--
|
|
<img src="Graphics/Java.gif">
|
|
<img src="Graphics/C++.gif">
|
|
-->
|
|
</dl>
|
|
|
|
|
|
|
|
|
|
<hr>
|
|
<dl>
|
|
<dt><strong>Name:</strong> <a name="Property-SetFilter">H5Pset_filter</a>
|
|
<dt><strong>Signature:</strong>
|
|
<dd><em>herr_t</em> <code>H5Pset_filter</code>(<em>hid_t</em> <code>plist</code>,
|
|
<em>H5Z_filter_t</em> <code>filter</code>,
|
|
<em>unsigned int</em> <code>flags</code>,
|
|
<em>size_t</em> <code>cd_nelmts</code>,
|
|
<em>const unsigned int</em> <code>cd_values[]</code>
|
|
)
|
|
<dt><strong>Purpose:</strong>
|
|
<dd>Adds a filter to the filter pipeline.
|
|
<dt><strong>Description:</strong>
|
|
<dd><code>H5Pset_filter</code> adds the specified
|
|
<code>filter</code> and corresponding properties to the
|
|
end of an output filter pipeline.
|
|
If <code>plist</code> is a dataset creation property list,
|
|
the filter is added to the permanent filter pipeline;
|
|
if <code>plist</code> is a dataset transfer property list,
|
|
the filter is added to the transient filter pipeline.
|
|
<p>
|
|
The array <code>cd_values</code> contains
|
|
<code>cd_nelmts</code> integers which are auxiliary data
|
|
for the filter. The integer values will be stored in the
|
|
dataset object header as part of the filter information.
|
|
<p>
|
|
The <code>flags</code> argument is a bit vector with
|
|
the following fields specifying certain general properties
|
|
of the filter:
|
|
<center>
|
|
<table align=center width="80%">
|
|
<tr valign=top>
|
|
<td valign=top><code>H5Z_FLAG_OPTIONAL</code></td>
|
|
<td> </td>
|
|
<td valign=top>If this bit is set then the filter is
|
|
optional. If the filter fails (see below) during an
|
|
<code>H5Dwrite()</code> operation then the filter is
|
|
just excluded from the pipeline for the chunk for which
|
|
it failed; the filter will not participate in the
|
|
pipeline during an <code>H5Dread()</code> of the chunk.
|
|
This is commonly used for compression filters: if the
|
|
compression result would be larger than the input then
|
|
the compression filter returns failure and the
|
|
uncompressed data is stored in the file. If this bit is
|
|
clear and a filter fails then <code>H5Dwrite()</code>
|
|
or <code>H5Dread()</code> also fails.</td>
|
|
</tr>
|
|
</table>
|
|
</center>
|
|
<dt><strong>Note:</strong>
|
|
<dd>This function currently supports only the permanent filter
|
|
pipeline; <code>plist_id</code> must be a dataset creation
|
|
property list.
|
|
<dt><strong>Parameters:</strong>
|
|
<dl>
|
|
<dt><em>hid_t</em> <code>plist</code>
|
|
<dd>IN: Property list identifier.
|
|
<dt><em>H5Z_filter_t</em> <code>filter</code>
|
|
<dd>IN: Filter to be added to the pipeline.
|
|
<dt><em>unsigned int</em> <code>flags</code>
|
|
<dd>IN: Bit vector specifying certain general properties
|
|
of the filter.
|
|
<dt><em>size_t</em> <code>cd_nelmts</code>
|
|
<dd>IN: Number of elements in <code>cd_values</code>.
|
|
<dt><em>const unsigned int</em> <code>cd_values[]</code>
|
|
<dd>IN: Auxiliary data for the filter.
|
|
</dl>
|
|
<dt><strong>Returns:</strong>
|
|
<dd>Returns a non-negative value if successful;
|
|
otherwise returns a negative value.
|
|
<dt><strong>Non-C API(s):</strong>
|
|
<dd><a href="fortran/h5p_FORTRAN.html#h5pset_filter_f"
|
|
target="FortranWin"><img src="Graphics/FORTRAN.gif" border=0></a>
|
|
<!--
|
|
<img src="Graphics/Java.gif">
|
|
<img src="Graphics/C++.gif">
|
|
-->
|
|
</dl>
|
|
|
|
|
|
<hr>
|
|
<dl>
|
|
<dt><strong>Name:</strong> <a name="Property-GetNFilters">H5Pget_nfilters</a>
|
|
<dt><strong>Signature:</strong>
|
|
<dd><em>int</em> <code>H5Pget_nfilters</code>(<em>hid_t</em> <code>plist</code>)
|
|
<dt><strong>Purpose:</strong>
|
|
<dd>Returns the number of filters in the pipeline.
|
|
<dt><strong>Description:</strong>
|
|
<dd><code>H5Pget_nfilters</code> returns the number of filters
|
|
defined in the filter pipeline associated with the property list
|
|
<code>plist</code>.
|
|
<p>
|
|
In each pipeline, the filters are numbered from
|
|
0 through <em>N</em>-1, where <em>N</em> is the value returned
|
|
by this function. During output to the file, the filters are
|
|
applied in increasing order; during input from the file, they
|
|
are applied in decreasing order.
|
|
<p>
|
|
<code>H5Pget_nfilters</code> returns the number of filters
|
|
in the pipeline, including zero (<code>0</code>) if there
|
|
are none.
|
|
<dt><strong>Note:</strong>
|
|
<dd>This function currently supports only the permanent filter
|
|
pipeline; <code>plist_id</code> must be a dataset creation
|
|
property list.
|
|
<dt><strong>Parameters:</strong>
|
|
<dl>
|
|
<dt><em>hid_t</em> <code>plist</code>
|
|
<dd>IN: Property list identifier.
|
|
</dl>
|
|
<dt><strong>Returns:</strong>
|
|
<dd>Returns the number of filters in the pipeline if successful;
|
|
otherwise returns a negative value.
|
|
<!--
|
|
<dt><strong>Non-C API(s):</strong>
|
|
<dd><a href="fortran/h5p_FORTRAN.html#h5pget_nfilters_f"
|
|
target="FortranWin"><img src="Graphics/FORTRAN.gif" border=0></a>
|
|
--> <!--
|
|
<img src="Graphics/Java.gif">
|
|
<img src="Graphics/C++.gif">
|
|
-->
|
|
</dl>
|
|
|
|
|
|
<hr>
|
|
<dl>
|
|
<dt><strong>Name:</strong> <a name="Property-GetFilter">H5Pget_filter</a>
|
|
<dt><strong>Signature:</strong>
|
|
<dd><em>H5Z_filter_t</em> <code>H5Pget_filter</code>(<em>hid_t</em> <code>plist</code>,
|
|
<em>int</em> <code>filter_number</code>,
|
|
<em>unsigned int *</em><code>flags</code>,
|
|
<em>size_t *</em><code>cd_nelmts</code>,
|
|
<em>unsigned int *</em><code>cd_values</code>,
|
|
<em>size_t</em> <code>namelen</code>,
|
|
<em>char</em> <code>name[]</code>
|
|
)
|
|
<dt><strong>Purpose:</strong>
|
|
<dd>Returns information about a filter in a pipeline.
|
|
<dt><strong>Description:</strong>
|
|
<dd><code> </code>
|
|
<code>H5Pget_filter</code> returns information about a
|
|
filter, specified by its filter number, in a filter pipeline,
|
|
specified by the property list with which it is associated.
|
|
<p>
|
|
If <code>plist</code> is a dataset creation property list,
|
|
the pipeline is a permanent filter pipeline;
|
|
if <code>plist</code> is a dataset transfer property list,
|
|
the pipeline is a transient filter pipeline.
|
|
<p>
|
|
On input, <code>cd_nelmts</code> indicates the number of entries
|
|
in the <code>cd_values</code> array, as allocated by the caller;
|
|
on return,<code>cd_nelmts</code> contains the number of values
|
|
defined by the filter.
|
|
<p>
|
|
<code>filter_number</code> is a value between zero and
|
|
<em>N</em>-1, as described in
|
|
<a href="#Property-GetNFilters"><code>H5Pget_nfilters()</code></a>.
|
|
The function will return a negative value if the filter number
|
|
is out of range.
|
|
<p>
|
|
If <code>name</code> is a pointer to an array of at least
|
|
<code>namelen</code> bytes, the filter name will be copied
|
|
into that array. The name will be null terminated if
|
|
<code>namelen</code> is large enough. The filter name returned
|
|
will be the name appearing in the file, the name registered
|
|
for the filter, or an empty string.
|
|
<p>
|
|
The structure of the <code>flags</code> argument is discussed
|
|
in <a href="#Property-SetFilter"><code>H5Pset_filter()</code></a>.
|
|
<dt><strong>Note:</strong>
|
|
<dd>This function currently supports only the permanent filter
|
|
pipeline; <code>plist</code> must be a dataset creation property
|
|
list.
|
|
<dt><strong>Parameters:</strong>
|
|
<dl>
|
|
<dt><em>hid_t</em> <code>plist</code>
|
|
<dd>IN: Property list identifier.
|
|
<dt><em>int</em> <code>filter_number</code>
|
|
<dd>IN: Sequence number within the filter pipeline of
|
|
the filter for which information is sought.
|
|
<dt><em>unsigned int *</em><code>flags</code>
|
|
<dd>OUT: Bit vector specifying certain general properties
|
|
of the filter.
|
|
<dt><em>size_t *</em><code>cd_nelmts</code>
|
|
<dd>IN/OUT: Number of elements in <code>cd_values</code>.
|
|
<dt><em>unsigned int *</em><code>cd_values</code>
|
|
<dd>OUT: Auxiliary data for the filter.
|
|
<dt><em>size_t</em> <code>namelen</code>
|
|
<dd>IN: Anticipated number of characters in <code>name</code>.
|
|
<dt><em>char</em> <code>name[]</code>
|
|
<dd>OUT: Name of the filter.
|
|
</dl>
|
|
<dt><strong>Returns:</strong>
|
|
<dd>Returns the filter identification number if successful.
|
|
Otherwise returns H5Z_FILTER_ERROR (-1).
|
|
<dt><strong>Non-C API(s):</strong>
|
|
<dd><a href="fortran/h5p_FORTRAN.html#h5pget_filter_f"
|
|
target="FortranWin"><img src="Graphics/FORTRAN.gif" border=0></a>
|
|
<!--
|
|
<img src="Graphics/Java.gif">
|
|
<img src="Graphics/C++.gif">
|
|
-->
|
|
</dl>
|
|
|
|
|
|
<hr>
|
|
<dl>
|
|
<dt><strong>Name:</strong> <a name="Property-GetDriver">H5Pget_driver</a>
|
|
<dt><strong>Signature:</strong>
|
|
<dd><em>H5F_driver_t</em> <code>H5Pget_driver</code>(<em>hid_t</em> <code>plist</code>
|
|
)
|
|
<dt><strong>Purpose:</strong>
|
|
<dd>Returns a low-level file driver identifier.
|
|
<dt><strong>Description:</strong>
|
|
<dd><code>H5Pget_driver</code> returns the identifier of the
|
|
low-level file driver. Valid identifiers are:
|
|
<ul>
|
|
<li>H5F_LOW_STDIO (0)
|
|
<li>H5F_LOW_SEC2 (1)
|
|
<li>H5F_LOW_MPIO (2)
|
|
<li>H5F_LOW_CORE (3)
|
|
<li>H5F_LOW_SPLIT (4)
|
|
<li>H5F_LOW_FAMILY (5)
|
|
</ul>
|
|
<dt><strong>Parameters:</strong>
|
|
<dl>
|
|
<dt><em>hid_t</em> <code>plist</code>
|
|
<dd>IN: Identifier of a file access property list.
|
|
</dl>
|
|
<dt><strong>Returns:</strong>
|
|
<dd>Returns a low-level driver identifier if successful.
|
|
Otherwise returns H5F_LOW_ERROR (-1).
|
|
<dt><strong>Non-C API(s):</strong>
|
|
<dd><a href="fortran/h5p_FORTRAN.html#h5pget_driver_f"
|
|
target="FortranWin"><img src="Graphics/FORTRAN.gif" border=0></a>
|
|
<!--
|
|
<img src="Graphics/Java.gif">
|
|
<img src="Graphics/C++.gif">
|
|
-->
|
|
</dl>
|
|
|
|
|
|
<hr>
|
|
<dl>
|
|
<dt><strong>Name:</strong> <a name="Property-SetStdio">H5Pset_stdio</a>
|
|
<dt><strong>Signature:</strong>
|
|
<dd><em>herr_t</em> <code>H5Pset_stdio</code>(<em>hid_t</em> <code>plist</code>)
|
|
<dt><strong>Purpose:</strong>
|
|
<dd>Sets the low level file driver to use the functions declared
|
|
in the stdio.h.
|
|
<dt><strong>Description:</strong>
|
|
<dd><code>H5Pset_stdio</code> sets the low level file driver to use
|
|
the functions declared in the stdio.h file: fopen(), fseek()
|
|
or fseek64(), fread(), fwrite(), and fclose().
|
|
<dt><strong>Parameters:</strong>
|
|
<dl>
|
|
<dt><em>hid_t</em> <code>plist</code>
|
|
<dd>IN: Identifier of a file access property list.
|
|
</dl>
|
|
<dt><strong>Returns:</strong>
|
|
<dd>Returns a non-negative value if successful;
|
|
otherwise returns a negative value.
|
|
<dt><strong>Non-C API(s):</strong>
|
|
<dd><a href="fortran/h5p_FORTRAN.html#h5pset_stdio_f"
|
|
target="FortranWin"><img src="Graphics/FORTRAN.gif" border=0></a>
|
|
<!--
|
|
<img src="Graphics/Java.gif">
|
|
<img src="Graphics/C++.gif">
|
|
-->
|
|
</dl>
|
|
|
|
|
|
<hr>
|
|
<dl>
|
|
<dt><strong>Name:</strong> <a name="Property-GetStdio">H5Pget_stdio</a>
|
|
<dt><strong>Signature:</strong>
|
|
<dd><em>herr_t</em> <code>H5Pget_stdio</code>(<em>hid_t</em> <code>plist</code>)
|
|
<dt><strong>Purpose:</strong>
|
|
<dd>Determines whether the file access property list is set to
|
|
the stdio driver.
|
|
<dt><strong>Description:</strong>
|
|
<dd><code>H5Pget_stdio</code> checks to determine whether the
|
|
file access property list is set to the stdio driver.
|
|
In the future, additional arguments may be added to this
|
|
function to match those added to H5Pset_stdio().
|
|
<dt><strong>Parameters:</strong>
|
|
<dl>
|
|
<dt><em>hid_t</em> <code>plist</code>
|
|
<dd>IN: Identifier of a file access property list.
|
|
</dl>
|
|
<dt><strong>Returns:</strong>
|
|
<dd>Returns a non-negative value if the file access property list is set
|
|
to the stdio driver.
|
|
Otherwise returns a negative value.
|
|
<dt><strong>Non-C API(s):</strong>
|
|
<dd><a href="fortran/h5p_FORTRAN.html#h5pget_stdio_f"
|
|
target="FortranWin"><img src="Graphics/FORTRAN.gif" border=0></a>
|
|
<!--
|
|
<img src="Graphics/Java.gif">
|
|
<img src="Graphics/C++.gif">
|
|
-->
|
|
</dl>
|
|
|
|
|
|
<hr>
|
|
<dl>
|
|
<dt><strong>Name:</strong> <a name="Property-SetSec2">H5Pset_sec2</a>
|
|
<dt><strong>Signature:</strong>
|
|
<dd><em>herr_t</em> <code>H5Pset_sec2</code>(<em>hid_t</em> <code>plist</code>
|
|
)
|
|
<dt><strong>Purpose:</strong>
|
|
<dd>Sets the low-level file driver to use the declared functions.
|
|
<dt><strong>Description:</strong>
|
|
<dd><code>H5Pset_sec2</code> sets the low-level file driver to use
|
|
the functions declared
|
|
in the unistd.h file: open(), lseek() or lseek64(), read(),
|
|
write(), and close().
|
|
<dt><strong>Parameters:</strong>
|
|
<dl>
|
|
<dt><em>hid_t</em> <code>plist</code>
|
|
<dd>IN: Identifier of a file access property list.
|
|
</dl>
|
|
<dt><strong>Returns:</strong>
|
|
<dd>Returns a non-negative value if successful;
|
|
otherwise returns a negative value.
|
|
<dt><strong>Non-C API(s):</strong>
|
|
<dd><a href="fortran/h5p_FORTRAN.html#h5pset_sec2_f"
|
|
target="FortranWin"><img src="Graphics/FORTRAN.gif" border=0></a>
|
|
<!--
|
|
<img src="Graphics/Java.gif">
|
|
<img src="Graphics/C++.gif">
|
|
-->
|
|
</dl>
|
|
|
|
|
|
<hr>
|
|
<dl>
|
|
<dt><strong>Name:</strong> <a name="Property-GetSec2">H5Pget_sec2</a>
|
|
<dt><strong>Signature:</strong>
|
|
<dd><em>herr_t</em> <code>H5Pget_sec2</code>(<em>hid_t</em> <code>plist</code>)
|
|
<dt><strong>Purpose:</strong>
|
|
<dd>Checks whether the file access property list is set
|
|
to the sec2 driver.
|
|
<dt><strong>Description:</strong>
|
|
<dd><code>H5Pget_sec2</code> checks to determine whether the
|
|
file access property list is set to the sec2 driver.
|
|
In the future, additional arguments may be
|
|
added to this function to match those added to H5Pset_sec2().
|
|
<dt><strong>Parameters:</strong>
|
|
<dl>
|
|
<dt><em>hid_t</em> <code>plist</code>
|
|
<dd>IN: Identifier of a file access property list.
|
|
</dl>
|
|
<dt><strong>Returns:</strong>
|
|
<dd>Returns a non-negative value if the file access property list is set
|
|
to the sec2 driver.
|
|
Otherwise returns a negative value.
|
|
<dt><strong>Non-C API(s):</strong>
|
|
<dd><a href="fortran/h5p_FORTRAN.html#h5pget_sec2_f"
|
|
target="FortranWin"><img src="Graphics/FORTRAN.gif" border=0></a>
|
|
<!--
|
|
<img src="Graphics/Java.gif">
|
|
<img src="Graphics/C++.gif">
|
|
-->
|
|
</dl>
|
|
|
|
|
|
<hr>
|
|
<dl>
|
|
<dt><strong>Name:</strong> <a name="Property-SetCore">H5Pset_core</a>
|
|
<dt><strong>Signature:</strong>
|
|
<dd><em>herr_t</em> <code>H5Pset_core</code>(<em>hid_t</em> <code>plist</code>,
|
|
<em>size_t</em> <code>increment</code>
|
|
)
|
|
<dt><strong>Purpose:</strong>
|
|
<dd>Sets the low-level file driver to use malloc() and free().
|
|
<dt><strong>Description:</strong>
|
|
<dd><code>H5Pset_core</code> sets the low-level file driver to use
|
|
<code>malloc()</code> and <code>free()</code>.
|
|
This driver is restricted to temporary files which are not
|
|
larger than the amount of virtual memory available.
|
|
The <code>increment</code> argument determines the file block size
|
|
and memory will be allocated in multiples of <code>increment</code> bytes.
|
|
A liberal <code>increment</code> results in fewer calls to
|
|
<code>realloc()</code> and probably less memory fragmentation.
|
|
<dt><strong>Parameters:</strong>
|
|
<dl>
|
|
<dt><em>hid_t</em> <code>plist</code>
|
|
<dd>IN: Identifier of a file access property list.
|
|
<dt><em>size_t</em> <code>increment</code>
|
|
<dd>IN: File block size in bytes.
|
|
Must be a positive value.
|
|
</dl>
|
|
<dt><strong>Returns:</strong>
|
|
<dd>Returns a non-negative value if successful;
|
|
otherwise returns a negative value.
|
|
<dt><strong>Non-C API(s):</strong>
|
|
<dd><a href="fortran/h5p_FORTRAN.html#h5pset_core_f"
|
|
target="FortranWin"><img src="Graphics/FORTRAN.gif" border=0></a>
|
|
<!--
|
|
<img src="Graphics/Java.gif">
|
|
<img src="Graphics/C++.gif">
|
|
-->
|
|
</dl>
|
|
|
|
|
|
<hr>
|
|
<dl>
|
|
<dt><strong>Name:</strong> <a name="Property-GetCore">H5Pget_core</a>
|
|
<dt><strong>Signature:</strong>
|
|
<dd><em>herr_t</em> <code>H5Pget_core</code>(<em>hid_t</em> <code>plist</code>,
|
|
<em>size_t</em> <code>*increment</code>
|
|
)
|
|
<dt><strong>Purpose:</strong>
|
|
<dd>Determines whether the file access property list is set
|
|
to the core driver.
|
|
<dt><strong>Description:</strong>
|
|
<dd><code>H5Pget_core</code> checks to determine whether the
|
|
file access property list is set to the core driver.
|
|
On success, the block size is returned through the
|
|
<code>increment</code> if it is not the null pointer.
|
|
In the future, additional arguments may be added to this
|
|
function to match those added to <code>H5Pset_core()</code>.
|
|
<dt><strong>Parameters:</strong>
|
|
<dl>
|
|
<dt><em>hid_t</em> <code>plist</code>
|
|
<dd>IN: Identifier of the file access property list.
|
|
<dt><em>size_t</em> <code>*increment</code>
|
|
<dd>OUT: Pointer to a location to return the file block size (in bytes).
|
|
</dl>
|
|
<dt><strong>Returns:</strong>
|
|
<dd>Returns a non-negative value if the file access property list is set
|
|
to the core driver.
|
|
Otherwise returns a negative value.
|
|
<dt><strong>Non-C API(s):</strong>
|
|
<dd><a href="fortran/h5p_FORTRAN.html#h5pget_core_f"
|
|
target="FortranWin"><img src="Graphics/FORTRAN.gif" border=0></a>
|
|
<!--
|
|
<img src="Graphics/Java.gif">
|
|
<img src="Graphics/C++.gif">
|
|
-->
|
|
</dl>
|
|
|
|
|
|
<hr>
|
|
<dl>
|
|
<dt><strong>Name:</strong> <a name="Property-SetSplit">H5Pset_split</a>
|
|
<dt><strong>Signature:</strong>
|
|
<dd><em>herr_t</em> <code>H5Pset_split</code>(<em>hid_t</em> <code>plist</code>,
|
|
<em>const char</em> <code>*meta_ext</code>,
|
|
<em>hid_t</em> <code>meta_plist</code>,
|
|
<em>const char</em> <code>*raw_ext</code>,
|
|
<em>hid_t</em> <code>raw_plist</code>
|
|
)
|
|
<dt><strong>Purpose:</strong>
|
|
<dd>Sets the low-level driver to split meta data from raw data.
|
|
<dt><strong>Description:</strong>
|
|
<dd><code>H5Pset_split</code> sets the low-level driver to
|
|
split meta data from raw data, storing meta data in one file and
|
|
raw data in another file. The meta file will have a name
|
|
which is formed by adding <em>meta_extension</em> (recommended
|
|
default value: <code>.meta</code>) to the end of the base name
|
|
and will be accessed according to the <em>meta_plist</em>.
|
|
The raw file will have a name which is formed by appending
|
|
<em>raw_extension</em> (recommended default value:
|
|
<code>.raw</code>) to the base name and will be accessed according
|
|
to the <em>raw_plist</em>.
|
|
Additional parameters may be added to this function in the future.
|
|
<dt><strong>Parameters:</strong>
|
|
<dl>
|
|
<dt><em>hid_t</em> <code>plist</code>
|
|
<dd>IN: Identifier of the file access property list.
|
|
<dt><em>const char</em> <code>*meta_ext</code>
|
|
<dd>IN: Name of the extension for the metafile filename.
|
|
Recommended default value: <code>.meta</code>.
|
|
<dt><em>hid_t</em> <code>meta_plist</code>
|
|
<dd>IN: Identifier of the meta file access property list.
|
|
<dt><em>const char</em> <code>*raw_ext</code>
|
|
<dd>IN: Name extension for the raw file filename.
|
|
Recommended default value: <code>.raw</code>.
|
|
<dt><em>hid_t</em> <code>raw_plist</code>
|
|
<dd>IN: Identifier of the raw file access property list.
|
|
</dl>
|
|
<dt><strong>Returns:</strong>
|
|
<dd>Returns a non-negative value if successful;
|
|
otherwise returns a negative value.
|
|
<dt><strong>Non-C API(s):</strong>
|
|
<dd><a href="fortran/h5p_FORTRAN.html#h5pset_split_f"
|
|
target="FortranWin"><img src="Graphics/FORTRAN.gif" border=0></a>
|
|
<!--
|
|
<img src="Graphics/Java.gif">
|
|
<img src="Graphics/C++.gif">
|
|
-->
|
|
</dl>
|
|
|
|
|
|
<hr>
|
|
<dl>
|
|
<dt><strong>Name:</strong> <a name="Property-GetSplit">H5Pget_split</a>
|
|
<dt><strong>Signature:</strong>
|
|
<dd><em>herr_t</em> <code>H5Pget_split</code>(<em>hid_t</em> <code>plist</code>,
|
|
<em>size_t</em> <code>meta_ext_size</code>,
|
|
<em>char</em> <code>*meta_ext</code>,
|
|
<em>hid_t</em> <code>*meta_plist</code>,
|
|
<em>size_t</em> <code>raw_ext_size</code>,
|
|
<em>char</em> <code>*raw_ext</code>,
|
|
<em>hid_t</em> <code>*raw_plist</code>
|
|
)
|
|
<dt><strong>Purpose:</strong>
|
|
<dd>Determines whether the file access property list is set
|
|
to the split driver.
|
|
<dt><strong>Description:</strong>
|
|
<dd><code>H5Pget_split</code> checks to determine whether the file
|
|
access property list is set to the split driver.
|
|
On successful return,
|
|
<code>meta_plist</code> and <code>raw_plist</code> will
|
|
point to copies of the meta and raw access property lists
|
|
which should be closed by calling <code>H5Pclose()</code> when
|
|
the application is finished with them, but if the meta and/or
|
|
raw file has no property list then a negative value is
|
|
returned for that property list identifier. Also, if
|
|
<code>meta_extension</code> and/or <code>raw_extension</code> are
|
|
non-null pointers, at most <code>meta_ext_size</code> or
|
|
<code>raw_ext_size</code> characters of the meta or raw file name
|
|
extension will be copied to the specified buffer. If the
|
|
actual name is longer than what was requested then the result
|
|
will not be null terminated (similar to
|
|
<code>strncpy()</code>). In the future, additional arguments
|
|
may be added to this function to match those added to
|
|
<code>H5Pset_split()</code>.
|
|
<dt><strong>Parameters:</strong>
|
|
<dl>
|
|
<dt><em>hid_t</em> <code>plist</code>
|
|
<dd>IN: Identifier of the file access property list.
|
|
<dt><em>size_t</em> <code>meta_ext_size</code>
|
|
<dd>IN: Number of characters of the meta file extension to be
|
|
copied to the <code>meta_ext</code> buffer.
|
|
<dt><em>char</em> <code>*meta_ext</code>
|
|
<dd>OUT: Meta file extension.
|
|
<dt><em>hid_t</em> <code>*meta_plist</code>
|
|
<dd>OUT: Pointer to a copy of the meta file access property list.
|
|
<dt><em>size_t</em> <code>raw_ext_size</code>
|
|
<dd>IN: Number of characters of the raw file extension to be
|
|
copied to the <code>raw_ext</code> buffer.
|
|
<dt><em>char</em> <code>*raw_ext</code>
|
|
<dd>OUT: Raw file extension.
|
|
<dt><em>hid_t</em> <code>*raw_plist</code>
|
|
<dd>OUT: Pointer to a copy of the raw file access property list.
|
|
</dl>
|
|
<dt><strong>Returns:</strong>
|
|
<dd>Returns a non-negative value if the file access property list is set
|
|
to the split driver.
|
|
Otherwise returns a negative value.
|
|
<dt><strong>Non-C API(s):</strong>
|
|
<dd><a href="fortran/h5p_FORTRAN.html#h5pget_split_f"
|
|
target="FortranWin"><img src="Graphics/FORTRAN.gif" border=0></a>
|
|
<!--
|
|
<img src="Graphics/Java.gif">
|
|
<img src="Graphics/C++.gif">
|
|
-->
|
|
</dl>
|
|
|
|
|
|
<hr>
|
|
<dl>
|
|
<dt><strong>Name:</strong> <a name="Property-SetGCReferences">H5Pset_gc_references</a>
|
|
<dt><strong>Signature:</strong>
|
|
<dd><em>herr_t</em> <code>H5Pset_gc_reference</code>(<em>hid_t</em> <code>plist</code>,
|
|
<em>unsigned</em> <code>gc_ref</code>
|
|
)
|
|
<dt><strong>Purpose:</strong>
|
|
<dd>Sets garbage collecting references flag.
|
|
<dt><strong>Description:</strong>
|
|
<dd><code>H5Pset_gc_references</code> sets the flag for
|
|
garbage collecting references for the file.
|
|
<p>
|
|
Dataset region references and other reference types use space
|
|
in an HDF5 file's global heap. If garbage collection is on
|
|
and the user passes in an uninitialized value in a reference structure,
|
|
the heap might get corrupted. When garbage collection is off, however,
|
|
and the user re-uses a reference, the previous heap block will be
|
|
orphaned and not returned to the free heap space.
|
|
<p>
|
|
When garbage collection is on, the user must initialize the
|
|
reference structures to 0 or risk heap corruption.
|
|
<p>
|
|
The default value for garbage collecting references is off.
|
|
<dt><strong>Parameters:</strong>
|
|
<dl>
|
|
<dt><em>hid_t</em> <code>plist</code>
|
|
<dd>IN: File access property list identifier.
|
|
<dt><em>unsigned</em> <code>gc_ref</code>
|
|
<dd>IN: Flag setting reference garbage collection to
|
|
on (<code>1</code>) or off (<code>0</code>).
|
|
</dl>
|
|
<dt><strong>Returns:</strong>
|
|
<dd>Returns a non-negative value if successful;
|
|
otherwise returns a negative value.
|
|
<dt><strong>Non-C API(s):</strong>
|
|
<dd><a href="fortran/h5p_FORTRAN.html#h5pset_gc_references_f"
|
|
target="FortranWin"><img src="Graphics/FORTRAN.gif" border=0></a>
|
|
<!--
|
|
<img src="Graphics/Java.gif">
|
|
<img src="Graphics/C++.gif">
|
|
-->
|
|
</dl>
|
|
|
|
<hr>
|
|
<dl>
|
|
<dt><strong>Name:</strong> <a name="Property-GetGCReferences">H5Pget_gc_references</a>
|
|
<dt><strong>Signature:</strong>
|
|
<dd><em>herr_t</em> <code>H5Pget_gc_references</code>(<em>hid_t</em> <code>plist</code>,
|
|
<em>unsigned</em> *<code>gc_ref</code>
|
|
)
|
|
<dt><strong>Purpose:</strong>
|
|
<dd>Returns garbage collecting references setting.
|
|
<dt><strong>Description:</strong>
|
|
<dd><code>H5Pget_gc_references</code> returns the current setting
|
|
for the garbage collection references property from
|
|
the specified file access property list.
|
|
The garbage collection references property is set
|
|
by <a href="#Property-SetGCReferences">H5Pset_gc_references</a>.
|
|
<dt><strong>Parameters:</strong>
|
|
<dl>
|
|
<dt><em>hid_t</em> <code>plist</code>
|
|
<dd>IN: File access property list identifier.
|
|
<dt><em>unsigned</em> <code>gc_ref</code>
|
|
<dd>OUT: Flag returning the state of reference garbage collection.
|
|
A returned value of <code>1</code> indicates that
|
|
garbage collection is on while
|
|
<code>0</code> indicates that garbage collection is off.
|
|
</dl>
|
|
<dt><strong>Returns:</strong>
|
|
<dd>Returns a non-negative value if successful;
|
|
otherwise returns a negative value.
|
|
<dt><strong>Non-C API(s):</strong>
|
|
<dd><a href="fortran/h5p_FORTRAN.html#h5pget_gc_references_f"
|
|
target="FortranWin"><img src="Graphics/FORTRAN.gif" border=0></a>
|
|
<!--
|
|
<img src="Graphics/Java.gif">
|
|
<img src="Graphics/C++.gif">
|
|
-->
|
|
</dl>
|
|
|
|
|
|
<!-- Not implemented. Probably never will be.
|
|
<hr>
|
|
<dl>
|
|
<dt><strong>Name:</strong> <a name="Property-SetFamily">H5Pset_family</a>
|
|
<dt><strong>Signature:</strong>
|
|
<dd><em>herr_t</em> <code>H5Pset_family</code>(<em>hid_t</em> <code>plist</code>,
|
|
<em>hsize_t</em> <code>memb_size</code>,
|
|
<em>hid_t</em> <code>memb_plist</code>
|
|
)
|
|
<dt><strong>Purpose:</strong>
|
|
<dd>Sets the file access properties list to the family driver.
|
|
<dt><strong>Description:</strong>
|
|
<dd><code>H5Pset_family</code> sets the file access properties
|
|
to use the family driver; any previously defined
|
|
driver properties are erased from the property list.
|
|
See <a href="Files.html#File_Families">File Families</a>
|
|
in the <cite>HDF5 User's Guide</cite> for a discussion
|
|
of file families.
|
|
<p>
|
|
Each member of the file family will use <code>memb_plist</code>
|
|
as its file access property list.
|
|
<p>
|
|
The <code>memb_size</code> argument gives the logical size
|
|
in bytes of each family member; the actual size could be
|
|
smaller depending on whether the file contains holes.
|
|
The member size is only used when creating a new file or
|
|
truncating an existing file; otherwise the member size comes
|
|
from the size of the first member of the family being
|
|
opened.
|
|
<p>
|
|
Note: If the size of the <code>off_t</code> type is
|
|
four bytes, then the maximum family member size is usually
|
|
2^31-1 because the byte at offset 2,147,483,647 is generally
|
|
inaccessible.
|
|
<p>
|
|
Additional parameters may be added to this function in the
|
|
future.
|
|
<dt><strong>Parameters:</strong>
|
|
<dl>
|
|
<dt><em>hid_t</em> <code>plist</code>
|
|
<dd>IN: Identifier of the file access property list.
|
|
<dt><em>hsize_t</em> <code>memb_size</code>
|
|
<dd>IN: Logical size, in bytes, of each family member.
|
|
<dt><em>hid_t</em> <code>memb_plist</code>
|
|
<dd>IN: Identifier of the file access property list
|
|
for each member of the family.
|
|
</dl>
|
|
<dt><strong>Returns:</strong>
|
|
<dd>Returns a non-negative value if successful;
|
|
otherwise returns a negative value.
|
|
<dt><strong>Non-C API(s):</strong>
|
|
<dd><a href="fortran/h5p_FORTRAN.html#h5pset_family_f"
|
|
target="FortranWin"><img src="Graphics/FORTRAN.gif" border=0></a>
|
|
<img src="Graphics/Java.gif">
|
|
<img src="Graphics/C++.gif">
|
|
</dl>
|
|
|
|
|
|
<hr>
|
|
<dl>
|
|
<dt><strong>Name:</strong> <a name="Property-GetFamily">H5Pget_family</a>
|
|
<dt><strong>Signature:</strong>
|
|
<dd><em>herr_t</em> <code>H5Pget_family</code>(<em>hid_t</em> <code>tid</code>,
|
|
<em>hsize_t</em> <code>*memb_size</code>,
|
|
<em>hid_t</em> <code>*memb_plist</code>
|
|
)
|
|
<dt><strong>Purpose:</strong>
|
|
<dd>Determines whether the file access property list
|
|
is set to the family driver.
|
|
<dt><strong>Description:</strong>
|
|
<dd><code>H5Pget_family</code> checks to determine whether the
|
|
file access property list is set to the family driver.
|
|
On successful return,
|
|
<em>access_properties</em> will point to a copy of the member
|
|
access property list which should be closed by calling
|
|
<code>H5Pclose()</code> when the application is finished with
|
|
it. If <em>memb_size</em> is non-null then it will contain
|
|
the logical size in bytes of each family member. In the
|
|
future, additional arguments may be added to this function to
|
|
match those added to <code>H5Pset_family()</code>.
|
|
<dt><strong>Parameters:</strong>
|
|
<dl>
|
|
<dt><em>hid_t</em> <code>plist</code>
|
|
<dd>IN: Identifier of the file access property list.
|
|
<dt><em>hsize_t</em> <code>*memb_size</code>
|
|
<dd>OUT: Logical size, in bytes, of each family member.
|
|
<dt><em>hid_t</em> <code>*memb_plist</code>
|
|
<dd>OUT: Identifier of the file access property list
|
|
for each member of the family.
|
|
</dl>
|
|
<dt><strong>Returns:</strong>
|
|
<dd>Returns a non-negative value if the file access property list is set
|
|
to the family driver.
|
|
Otherwise returns a negative value.
|
|
<dt><strong>Non-C API(s):</strong>
|
|
<dd><a href="fortran/h5p_FORTRAN.html#h5pget_family_f"
|
|
target="FortranWin"><img src="Graphics/FORTRAN.gif" border=0></a>
|
|
<img src="Graphics/Java.gif">
|
|
<img src="Graphics/C++.gif">
|
|
</dl>
|
|
-->
|
|
|
|
|
|
<hr>
|
|
<dl>
|
|
<dt><strong>Name:</strong> <a name="Property-SetCache">H5Pset_cache</a>
|
|
<dt><strong>Signature:</strong>
|
|
<dd><em>herr_t</em> <code>H5Pset_cache</code>(<em>hid_t</em> <code>plist_id</code>,
|
|
<em>int</em> <code>mdc_nelmts</code>,
|
|
<em>int</em> <code>rdcc_nelmts</code>,
|
|
<em>size_t</em> <code>rdcc_nbytes</code>,
|
|
<em>double</em> <code>rdcc_w0</code>
|
|
)
|
|
<dt><strong>Purpose:</strong>
|
|
<dd>Sets the meta data cache and raw data chunk cache parameters.
|
|
<dt><strong>Description:</strong>
|
|
<dd><code>H5Pset_cache</code> sets
|
|
the number of elements (objects) in the meta data cache and
|
|
the number of elements, the total number of bytes, and
|
|
the preemption policy value in the raw data chunk cache.
|
|
<p>
|
|
The <em>plist_id</em> is a file access property list.
|
|
The number of elements (objects) in the meta data cache
|
|
and the raw data chunk cache are <em>mdc_nelmts</em> and
|
|
<em>rdcc_nelmts</em>, respectively.
|
|
The total size of the raw data chunk cache and the preemption policy
|
|
are <em>rdcc_nbytes</em> and <em>rdcc_w0</em>.
|
|
<p>
|
|
Any (or all) of the <code>H5Pget_cache()</code> pointer arguments
|
|
may be null pointers.
|
|
<p>
|
|
The <em>rdcc_w0</em> value should be between 0 and 1 inclusive and
|
|
indicates how much chunks that have been fully read are
|
|
favored for preemption. A value of zero means fully read
|
|
chunks are treated no differently than other chunks (the
|
|
preemption is strictly LRU) while a value of one means fully
|
|
read chunks are always preempted before other chunks.
|
|
<dt><strong>Parameters:</strong>
|
|
<dl>
|
|
<dt><em>hid_t</em> <code>plist_id</code>
|
|
<dd>IN: Identifier of the file access property list.
|
|
<dt><em>int</em> <code>mdc_nelmts</code>
|
|
<dd>IN: Number of elements (objects) in the meta data cache.
|
|
<dt><em>int</em> <code>rdcc_nelmts</code>
|
|
<dd>IN: Number of elements (objects) in the raw data chunk cache.
|
|
<dt><em>size_t</em> <code>rdcc_nbytes</code>
|
|
<dd>IN: Total size of the raw data chunk cache, in bytes.
|
|
<dt><em>double</em> <code>rdcc_w0</code>
|
|
<dd>IN: Preemption policy.
|
|
</dl>
|
|
<dt><strong>Returns:</strong>
|
|
<dd>Returns a non-negative value if successful;
|
|
otherwise returns a negative value.
|
|
<dt><strong>Non-C API(s):</strong>
|
|
<dd><a href="fortran/h5p_FORTRAN.html#h5pset_cache_f"
|
|
target="FortranWin"><img src="Graphics/FORTRAN.gif" border=0></a>
|
|
<!--
|
|
<img src="Graphics/Java.gif">
|
|
<img src="Graphics/C++.gif">
|
|
-->
|
|
</dl>
|
|
|
|
|
|
<hr>
|
|
<dl>
|
|
<dt><strong>Name:</strong> <a name="Property-GetCache">H5Pget_cache</a>
|
|
<dt><strong>Signature:</strong>
|
|
<dd><em>herr_t</em> <code>H5Pget_cache</code>(<em>hid_t</em> <code>plist_id</code>,
|
|
<em>int</em> <code>*mdc_nelmts</code>,
|
|
<em>int</em> <code>*rdcc_nelmts</code>,
|
|
<em>size_t</em> <code>*rdcc_nbytes</code>,
|
|
<em>double</em> <code>*rdcc_w0</code>
|
|
)
|
|
<dt><strong>Purpose:</strong>
|
|
<dd>Queries the meta data cache and raw data chunk cache parameters.
|
|
<dt><strong>Description:</strong>
|
|
<dd><code>H5Pget_cache</code> retrieves the maximum possible
|
|
number of elements in the meta
|
|
data cache and raw data chunk cache, the maximum possible number of
|
|
bytes in the raw data chunk cache, and the preemption policy value.
|
|
<p>
|
|
Any (or all) arguments may be null pointers, in which case the
|
|
corresponding datum is not returned.
|
|
<dt><strong>Parameters:</strong>
|
|
<dl>
|
|
<dt><em>hid_t</em> <code>plist_id</code>
|
|
<dd>IN: Identifier of the file access property list.
|
|
<dt><em>int</em> <code>*mdc_nelmts</code>
|
|
<dd>IN/OUT: Number of elements (objects) in the meta data cache.
|
|
<dt><em>int</em> <code>*rdcc_nelmts</code>
|
|
<dd>IN/OUT: Number of elements (objects) in the raw data chunk cache.
|
|
<dt><em>size_t</em> <code>*rdcc_nbytes</code>
|
|
<dd>IN/OUT: Total size of the raw data chunk cache, in bytes.
|
|
<dt><em>double</em> <code>*rdcc_w0</code>
|
|
<dd>IN/OUT: Preemption policy.
|
|
</dl>
|
|
<dt><strong>Returns:</strong>
|
|
<dd>Returns a non-negative value if successful;
|
|
otherwise returns a negative value.
|
|
<dt><strong>Non-C API(s):</strong>
|
|
<dd><a href="fortran/h5p_FORTRAN.html#h5pget_cache_f"
|
|
target="FortranWin"><img src="Graphics/FORTRAN.gif" border=0></a>
|
|
<!--
|
|
<img src="Graphics/Java.gif">
|
|
<img src="Graphics/C++.gif">
|
|
-->
|
|
</dl>
|
|
|
|
|
|
<hr>
|
|
<dl>
|
|
<dt><strong>Name:</strong> <a name="Property-SetHyperCache">H5Pset_hyper_cache</a>
|
|
<dt><strong>Signature:</strong>
|
|
<dd><em>herr_t</em> <code>H5Pset_hyper_cache</code>(<em>hid_t</em> <code>plist</code>,
|
|
<em>unsigned</em> <code>cache</code>,
|
|
<em>unsigned</em> <code>limit</code>
|
|
)
|
|
<dt><strong>Purpose:</strong>
|
|
<dd>Indicates whether to cache hyperslab blocks during I/O.
|
|
<dt><strong>Description:</strong>
|
|
<dd>Given a dataset transfer property list, <code>H5Pset_hyper_cache</code>
|
|
indicates whether to cache hyperslab blocks during I/O,
|
|
a process which can significantly increase I/O speeds.
|
|
<p>
|
|
When working with hyperslab selections, it is possible to
|
|
significantly speed up I/O operations by retrieving an
|
|
entire hyperslab from the file in one operation and
|
|
caching it in memory.
|
|
The <code>cache</code> parameter specifies whether to turn
|
|
caching on for hyperslab I/O operations.
|
|
If <code>cache</code> is set to <code>1</code>,
|
|
caching is turned on;
|
|
if set to <code>0</code>, caching is turned off.
|
|
<p>
|
|
The parameter <code>limit</code> sets the maximum size of the
|
|
hyperslab block to cache. If a block is smaller than that limit,
|
|
it may still not be cached if no memory is available.
|
|
Setting <code>limit</code> to <code>0</code> (zero) indicates
|
|
no limitation on the size of block to attempt to cache.
|
|
<p>
|
|
The default is to cache blocks with no limit on block size
|
|
for serial I/O and to not cache blocks for parallel I/O.
|
|
<dt><strong>Parameters:</strong>
|
|
<dl>
|
|
<dt><em>hid_t</em> <code>plist</code>
|
|
<dd>IN: Dataset transfer property list identifier.
|
|
<dt><em>unsigned</em> <code>cache</code>
|
|
<dd>IN: A flag indicating whether caching is to be
|
|
set to on (<code>1</code>) or off (<code>0</code>).
|
|
<dt><em>unsigned</em> <code>limit</code>
|
|
<dd>IN: Maximum size of the hyperslab block to cache.
|
|
<code>0</code> (zero) indicates no limit.
|
|
</dl>
|
|
<dt><strong>Returns:</strong>
|
|
<dd>Returns a non-negative value if successful;
|
|
otherwise returns a negative value.
|
|
<dt><strong>Non-C API(s):</strong>
|
|
<dd><a href="fortran/h5p_FORTRAN.html#h5pset_hyper_cache_f"
|
|
target="FortranWin"><img src="Graphics/FORTRAN.gif" border=0></a>
|
|
<!--
|
|
<img src="Graphics/Java.gif">
|
|
<img src="Graphics/C++.gif">
|
|
-->
|
|
</dl>
|
|
|
|
|
|
<hr>
|
|
<dl>
|
|
<dt><strong>Name:</strong> <a name="Property-GetHyperCache">H5Pget_hyper_cache</a>
|
|
<dt><strong>Signature:</strong>
|
|
<dd><em>herr_t</em> <code>H5Pget_hyper_cache</code>(<em>hid_t</em> <code>plist</code>,
|
|
<em>unsigned</em> *<code>cache</code>,
|
|
<em>unsigned</em> *<code>limit</code>
|
|
)
|
|
<dt><strong>Purpose:</strong>
|
|
<dd>Returns information regarding the caching of hyperslab blocks during I/O.
|
|
<dt><strong>Description:</strong>
|
|
<dd>Given a dataset transfer property list, <code>H5Pget_hyper_cache</code>
|
|
returns instructions regarding the caching of hyperslab blocks during I/O.
|
|
These parameters are set with the <code>H5Pset_hyper_cache</code> function.
|
|
<dt><strong>Parameters:</strong>
|
|
<dl>
|
|
<dt><em>hid_t</em> <code>plist</code>
|
|
<dd>IN: Dataset transfer property list identifier.
|
|
<dt><em>unsigned</em> *<code>cache</code>
|
|
<dd>OUT: A flag indicating whether caching is
|
|
set to on (<code>1</code>) or off (<code>0</code>).
|
|
<dt><em>unsigned</em> *<code>limit</code>
|
|
<dd>OUT: Maximum size of the hyperslab block to cache.
|
|
<code>0</code> (zero) indicates no limit.
|
|
</dl>
|
|
<dt><strong>Returns:</strong>
|
|
<dd>Returns a non-negative value if successful;
|
|
otherwise returns a negative value.
|
|
<dt><strong>Non-C API(s):</strong>
|
|
<dd><a href="fortran/h5p_FORTRAN.html#h5pget_hyper_cache_f"
|
|
target="FortranWin"><img src="Graphics/FORTRAN.gif" border=0></a>
|
|
<!--
|
|
<img src="Graphics/Java.gif">
|
|
<img src="Graphics/C++.gif">
|
|
-->
|
|
</dl>
|
|
|
|
|
|
<hr>
|
|
<dl>
|
|
<dt><strong>Name:</strong> <a name="Property-SetBTreeRatios">H5Pset_btree_ratios</a>
|
|
<dt><strong>Signature:</strong>
|
|
<dd><em>herr_t</em> <code>H5Pset_btree_ratios</code>(<em>hid_t</em> <code>plist</code>,
|
|
<em>double</em> <code>left</code>,
|
|
<em>double</em> <code>middle</code>,
|
|
<em>double</em> <code>right</code>
|
|
)
|
|
<dt><strong>Purpose:</strong>
|
|
<dd>Sets B-tree split ratios for a dataset transfer property list.
|
|
<dt><strong>Description:</strong>
|
|
<dd><code>H5Pset_btree_ratios</code> sets the B-tree split ratios
|
|
for a dataset transfer property list. The split ratios determine
|
|
what percent of children go in the first node when a node splits.
|
|
<p>
|
|
The ratio <code>left</code> is used when the splitting node is
|
|
the left-most node at its level in the tree;
|
|
the ratio <code>right</code> is used when the splitting node is
|
|
the right-most node at its level;
|
|
and the ratio <code>middle</code> is used for all other cases.
|
|
<p>
|
|
A node which is the only node at its level in the tree uses
|
|
the ratio <code>right</code> when it splits.
|
|
<p>
|
|
All ratios are real numbers between 0 and 1, inclusive.
|
|
<dt><strong>Parameters:</strong>
|
|
<dl>
|
|
<dt><em>hid_t</em> <code>plist</code>
|
|
<dd>IN: The dataset transfer property list identifier.
|
|
<dt><em>double</em> <code>left</code>
|
|
<dd>IN: The B-tree split ratio for left-most nodes.
|
|
<dt><em>double</em> <code>right</code>
|
|
<dd>IN: The B-tree split ratio for right-most nodes and lone nodes.
|
|
<dt><em>double</em> <code>middle</code>
|
|
<dd>IN: The B-tree split ratio for all other nodes.
|
|
</dl>
|
|
<dt><strong>Returns:</strong>
|
|
<dd>Returns a non-negative value if successful;
|
|
otherwise returns a negative value.
|
|
<dt><strong>Non-C API(s):</strong>
|
|
<dd><a href="fortran/h5p_FORTRAN.html#h5pset_btree_ratios_f"
|
|
target="FortranWin"><img src="Graphics/FORTRAN.gif" border=0></a>
|
|
<!--
|
|
<img src="Graphics/Java.gif">
|
|
<img src="Graphics/C++.gif">
|
|
-->
|
|
</dl>
|
|
|
|
|
|
<hr>
|
|
<dl>
|
|
<dt><strong>Name:</strong> <a name="Property-GetBTreeRatios">H5Pget_btree_ratios</a>
|
|
<dt><strong>Signature:</strong>
|
|
<dd><em>herr_t</em> <code>H5Pget_btree_ratios</code>(<em>hid_t</em> <code>plist</code>,
|
|
<em>double</em> *<code>left</code>,
|
|
<em>double</em> *<code>middle</code>,
|
|
<em>double</em> *<code>right</code>
|
|
)
|
|
<dt><strong>Purpose:</strong>
|
|
<dd>Gets B-tree split ratios for a dataset transfer property list.
|
|
<dt><strong>Description:</strong>
|
|
<dd><code>H5Pget_btree_ratios</code> returns the B-tree split ratios
|
|
for a dataset transfer property list.
|
|
<p>
|
|
The B-tree split ratios are returned through the non-<code>NULL</code>
|
|
arguments <code>left</code>, <code>middle</code>, and <code>right</code>,
|
|
as set by the <a href="#Property-SetBTreeRatios">H5Pset_btree_ratios</a> function.
|
|
<dt><strong>Parameters:</strong>
|
|
<dl>
|
|
<dt><em>hid_t</em> <code>plist</code>
|
|
<dd>IN: The dataset transfer property list identifier.
|
|
<dt><em>double</em> <code>left</code>
|
|
<dd>OUT: The B-tree split ratio for left-most nodes.
|
|
<dt><em>double</em> <code>right</code>
|
|
<dd>OUT: The B-tree split ratio for right-most nodes and lone nodes.
|
|
<dt><em>double</em> <code>middle</code>
|
|
<dd>OUT: The B-tree split ratio for all other nodes.
|
|
</dl>
|
|
<dt><strong>Returns:</strong>
|
|
<dd>Returns a non-negative value if successful;
|
|
otherwise returns a negative value.
|
|
<dt><strong>Non-C API(s):</strong>
|
|
<dd><a href="fortran/h5p_FORTRAN.html#h5pget_btree_ratios_f"
|
|
target="FortranWin"><img src="Graphics/FORTRAN.gif" border=0></a>
|
|
<!--
|
|
<img src="Graphics/Java.gif">
|
|
<img src="Graphics/C++.gif">
|
|
-->
|
|
</dl>
|
|
|
|
|
|
<hr>
|
|
<dl>
|
|
<dt><strong>Name:</strong> <a name="Property-SetBuffer">H5Pset_buffer</a>
|
|
<dt><strong>Signature:</strong>
|
|
<dd><em>herr_t</em> <code>H5Pset_buffer</code>(<em>hid_t</em> <code>plist</code>,
|
|
<em>size_t</em> <code>size</code>,
|
|
<em>void</em> <code>*tconv</code>,
|
|
<em>void</em> <code>*bkg</code>
|
|
)
|
|
<dt><strong>Purpose:</strong>
|
|
<dd>Sets type conversion and background buffers.
|
|
<dt><strong>Description:</strong>
|
|
<dd> Given a dataset transfer property list, <code>H5Pset_buffer</code>
|
|
sets the maximum size
|
|
for the type conversion buffer and background buffer and
|
|
optionally supplies pointers to application-allocated buffers.
|
|
If the buffer size is smaller than the entire amount of data
|
|
being transferred between the application and the file, and a type
|
|
conversion buffer or background buffer is required, then
|
|
strip mining will be used.
|
|
<p>
|
|
Note that there are minimum size requirements for the buffer.
|
|
Strip mining can only break the data up along the first dimension,
|
|
so the buffer must be large enough to accommodate a complete slice
|
|
that encompasses all of the remaining dimensions.
|
|
For example, when strip mining a 100x200x300 hyperslab
|
|
of a simple data space, the buffer must be large enough to
|
|
hold 1x200x300 data elements.
|
|
When strip mining a 100x200x300x150 hyperslab of a simple data space,
|
|
the buffer must be large enough to hold 1x200x300x150 data elements.
|
|
<p>
|
|
If <code>tconv</code> and/or <code>bkg</code> are null pointers,
|
|
then buffers will be allocated and freed during the data transfer.
|
|
<p>
|
|
The default value for the maximum buffer is 1 Mb.
|
|
<dt><strong>Parameters:</strong>
|
|
<dl>
|
|
<dt><em>hid_t</em> <code>plist</code>
|
|
<dd>IN: Identifier for the dataset transfer property list.
|
|
<dt><em>size_t</em> <code>size</code>
|
|
<dd>IN: Size, in bytes, of the type conversion and background buffers.
|
|
<dt><em>void</em> <code>tconv</code>
|
|
<dd>IN: Pointer to application-allocated type conversion buffer.
|
|
<dt><em>void</em> <code>bkg</code>
|
|
<dd>IN: Pointer to application-allocated background buffer.
|
|
</dl>
|
|
<dt><strong>Returns:</strong>
|
|
<dd>Returns a non-negative value if successful;
|
|
otherwise returns a negative value.
|
|
<!--
|
|
<dt><strong>Non-C API(s):</strong>
|
|
<dd><a href="fortran/h5p_FORTRAN.html#h5pxxx"
|
|
target="FortranWin"><img src="Graphics/FORTRAN.gif" border=0></a>
|
|
--> <!--
|
|
<img src="Graphics/Java.gif">
|
|
<img src="Graphics/C++.gif">
|
|
-->
|
|
</dl>
|
|
|
|
|
|
<hr>
|
|
<dl>
|
|
<dt><strong>Name:</strong> <a name="Property-GetBuffer">H5Pget_buffer</a>
|
|
<dt><strong>Signature:</strong>
|
|
<dd><em>size_t</em> <code>H5Pget_buffer</code>(<em>hid_t</em> <code>plist</code>,
|
|
<em>void</em> <code>**tconv</code>,
|
|
<em>void</em> <code>**bkg</code>
|
|
)
|
|
<dt><strong>Purpose:</strong>
|
|
<dd>Reads buffer settings.
|
|
<dt><strong>Description:</strong>
|
|
<dd><code>H5Pget_buffer</code> reads values previously set
|
|
with H5Pset_buffer().
|
|
<dt><strong>Parameters:</strong>
|
|
<dl>
|
|
<dt><em>hid_t</em> <code>plist</code>
|
|
<dd>IN: Identifier for the dataset transfer property list.
|
|
<dt><em>void</em> <code>**tconv</code>
|
|
<dd>OUT: Address of the pointer to application-allocated
|
|
type conversion buffer.
|
|
<dt><em>void</em> <code>**bkg</code>
|
|
<dd>OUT: Address of the pointer to application-allocated
|
|
background buffer.
|
|
</dl>
|
|
<dt><strong>Returns:</strong>
|
|
<dd>Returns buffer size, in bytes, if successful;
|
|
otherwise 0 on failure.
|
|
<!--
|
|
<dt><strong>Non-C API(s):</strong>
|
|
<dd><a href="fortran/h5p_FORTRAN.html#h5pxxx"
|
|
target="FortranWin"><img src="Graphics/FORTRAN.gif" border=0></a>
|
|
--> <!--
|
|
<img src="Graphics/Java.gif">
|
|
<img src="Graphics/C++.gif">
|
|
-->
|
|
</dl>
|
|
|
|
|
|
<hr>
|
|
<dl>
|
|
<dt><strong>Name:</strong> <a name="Property-SetPreserve">H5Pset_preserve</a>
|
|
<dt><strong>Signature:</strong>
|
|
<dd><em>herr_t</em> <code>H5Pset_preserve</code>(<em>hid_t</em> <code>plist</code>,
|
|
<em>hbool_t</em> <code>status</code>
|
|
)
|
|
<dt><strong>Purpose:</strong>
|
|
<dd>Sets the dataset transfer property list status to TRUE or FALSE.
|
|
<dt><strong>Description:</strong>
|
|
<dd><code>H5Pset_preserve</code> sets the
|
|
dataset transfer property list status to TRUE or FALSE.
|
|
<p>
|
|
When reading or writing compound data types and the
|
|
destination is partially initialized and the read/write is
|
|
intended to initialize the other members, one must set this
|
|
property to TRUE. Otherwise the I/O pipeline treats the
|
|
destination datapoints as completely uninitialized.
|
|
<dt><strong>Parameters:</strong>
|
|
<dl>
|
|
<dt><em>hid_t</em> <code>plist</code>
|
|
<dd>IN: Identifier for the dataset transfer property list.
|
|
<dt><em>hbool_t</em> <code>status</code>
|
|
<dd>IN: Status of for the dataset transfer property list
|
|
(TRUE/FALSE).
|
|
</dl>
|
|
<dt><strong>Returns:</strong>
|
|
<dd>Returns a non-negative value if successful;
|
|
otherwise returns a negative value.
|
|
<!--
|
|
<dt><strong>Non-C API(s):</strong>
|
|
<dd><a href="fortran/h5p_FORTRAN.html#h5pxxx"
|
|
target="FortranWin"><img src="Graphics/FORTRAN.gif" border=0></a>
|
|
--> <!--
|
|
<img src="Graphics/Java.gif">
|
|
<img src="Graphics/C++.gif">
|
|
-->
|
|
</dl>
|
|
|
|
|
|
<hr>
|
|
<dl>
|
|
<dt><strong>Name:</strong> <a name="Property-GetPreserve">H5Pget_preserve</a>
|
|
<dt><strong>Signature:</strong>
|
|
<dd><em>int</em> <code>H5Pget_preserve</code>(<em>hid_t</em> <code>plist</code>)
|
|
<dt><strong>Purpose:</strong>
|
|
<dd>Checks status of the dataset transfer property list.
|
|
<dt><strong>Description:</strong>
|
|
<dd><code>H5Pget_preserve</code> checks the status of the
|
|
dataset transfer property list.
|
|
<dt><strong>Parameters:</strong>
|
|
<dl>
|
|
<dt><em>hid_t</em> <code>plist</code>
|
|
<dd>IN: Identifier for the dataset transfer property list.
|
|
</dl>
|
|
<dt><strong>Returns:</strong>
|
|
<dd>Returns TRUE or FALSE if successful;
|
|
otherwise returns a negative value.
|
|
<!--
|
|
<dt><strong>Non-C API(s):</strong>
|
|
<dd><a href="fortran/h5p_FORTRAN.html#h5pxxx"
|
|
target="FortranWin"><img src="Graphics/FORTRAN.gif" border=0></a>
|
|
--> <!--
|
|
<img src="Graphics/Java.gif">
|
|
<img src="Graphics/C++.gif">
|
|
-->
|
|
</dl>
|
|
|
|
|
|
<!--
|
|
|
|
<hr>
|
|
<dl>
|
|
<dt><strong>Name:</strong> <a name="Property-SetCompression">H5Pset_compression</a>
|
|
<dt><strong>Signature:</strong>
|
|
<dd><em>herr_t</em> <code>H5Pset_compression</code>(<em>hid_t</em> <code>plist</code>,
|
|
<em>H5Z_method_t</em> <code>method</code>,
|
|
<em>unsigned int</em> <code>flags</code>,
|
|
<em>size_t</em> <code>cd_size</code>,
|
|
<em>const void</em> <code>*client_data</code>
|
|
)
|
|
<dt><strong>Purpose:</strong>
|
|
<dd>Sets compression method.
|
|
<dt><strong>Description:</strong>
|
|
<dd><code>H5Pset_compression</code> sets the compression method
|
|
in a dataset creation property list. This is a catch-all
|
|
function for defining compression methods
|
|
and is intended to be called from a wrapper such as
|
|
<code>H5Pset_deflate()</code>. The dataset creation property
|
|
list <em>plist</em> is adjusted to use the specified
|
|
compression method. The <em>flags</em> is an 8-bit vector
|
|
which is stored in the file as part of the compression message
|
|
and passed to the compress and uncompress functions. The
|
|
<em>client_data</em> is a byte array of length
|
|
<em>cd_size</em> which is copied to the file and passed to the
|
|
compress and uncompress methods.
|
|
<p>
|
|
The FLAGS, CD_SIZE, and CLIENT_DATA are copied to the
|
|
property list and eventually to the file and passed to the
|
|
compression functions.
|
|
<p>
|
|
See <a href="Compression.html"><cite>Compression</cite></a>
|
|
in the <cite>HDF5 User's Guide</cite> for further information.
|
|
<dt><strong>Parameters:</strong>
|
|
<dl>
|
|
<dt><em>hid_t</em> <code>plist</code>
|
|
<dd>IN: Identifier for the dataset creation property list.
|
|
<dt><em>H5Z_method_t</em> <code>method</code>
|
|
<dd>IN: Compression method, an integer from 16 to 225.
|
|
<dt><em>unsigned int</em> <code>flags</code>
|
|
<dd>IN: Compression flags.
|
|
<dt><em>size_t</em> <code>cd_size</code>
|
|
<dd>IN: Size of the byte array <code>client_data</code>.
|
|
<dt><em>const void</em> <code>*client_data</code>
|
|
<dd>IN: Client data byte array passed to the compression method.
|
|
</dl>
|
|
<dt><strong>Returns:</strong>
|
|
<dd>Returns a non-negative value if successful;
|
|
otherwise returns a negative value.
|
|
<dt><strong>Non-C API(s):</strong>
|
|
<dd><a href="fortran/h5p_FORTRAN.html#h5pxxx"
|
|
target="FortranWin"><img src="Graphics/FORTRAN.gif" border=0></a>
|
|
<img src="Graphics/Java.gif">
|
|
<img src="Graphics/C++.gif">
|
|
</dl>
|
|
|
|
-->
|
|
|
|
|
|
<!--
|
|
|
|
<hr>
|
|
<dl>
|
|
<dt><strong>Name:</strong> <a name="Property-GetCompression">H5Pget_compression</a>
|
|
<dt><strong>Signature:</strong>
|
|
<dd><em>H5Z_method_t</em> <code>H5Pget_compression</code>(<em>hid_t</em> <code>plist</code>,
|
|
<em>unsigned int</em> <code>*flags</code>,
|
|
<em>size_t</em> <code>*cd_size</code>,
|
|
<em>void</em> <code>*client_data</code>
|
|
)
|
|
<dt><strong>Purpose:</strong>
|
|
<dd>Gets compression method.
|
|
<dt><strong>Description:</strong>
|
|
<dd><code>H5Pget_compression</code> gets the compression method
|
|
information from a dataset creation property list.
|
|
The <code>client_data</code> buffer is initially
|
|
<code>cd_size</code> bytes. On return, <code>client_data</code>
|
|
will be initialized with at most that many bytes, and
|
|
<code>cd_size</code> will contain the actual size of the
|
|
client data, which might be larger than its original value.
|
|
<dt><strong>Parameters:</strong>
|
|
<dl>
|
|
<dt><em>hid_t</em> <code>plist</code>
|
|
<dd>IN: Identifier for the dataset creation property list.
|
|
<dt><em>unsigned int</em> <code>*flags</code>
|
|
<dd>OUT: Compression flags.
|
|
<dt><em>size_t</em> <code>*cd_size</code>
|
|
<dd>IN/OUT: Size of the <code>client_data</code> array.
|
|
<dt><em>void</em> <code>*client_data</code>
|
|
<dd>OUT: Byte array for the client data.
|
|
</dl>
|
|
<dt><strong>Returns:</strong>
|
|
<dd>Returns compression method if successful;
|
|
otherwise returns a negative value.
|
|
<dt><strong>Non-C API(s):</strong>
|
|
<dd><a href="fortran/h5p_FORTRAN.html#h5pxxx"
|
|
target="FortranWin"><img src="Graphics/FORTRAN.gif" border=0></a>
|
|
<img src="Graphics/Java.gif">
|
|
<img src="Graphics/C++.gif">
|
|
</dl>
|
|
|
|
-->
|
|
|
|
|
|
<hr>
|
|
<dl>
|
|
<dt><strong>Name:</strong> <a name="Property-SetDeflate">H5Pset_deflate</a>
|
|
<dt><strong>Signature:</strong>
|
|
<dd><em>herr_t</em> <code>H5Pset_deflate</code>(<em>hid_t</em> <code>plist</code>,
|
|
<em>int</em> <code>level</code>
|
|
)
|
|
<dt><strong>Purpose:</strong>
|
|
<dd>Sets compression method and compression level.
|
|
<dt><strong>Description:</strong>
|
|
<dd><code>H5Pset_deflate</code> sets the compression method for a
|
|
dataset creation property list to <code>H5D_COMPRESS_DEFLATE</code>
|
|
and the compression level to <code>level</code>, which should
|
|
be a value from zero to nine, inclusive.
|
|
Lower compression levels are faster but result in less compression.
|
|
This is the same algorithm as used by the GNU gzip program.
|
|
<dt><strong>Parameters:</strong>
|
|
<dl>
|
|
<dt><em>hid_t</em> <code>plist</code>
|
|
<dd>IN: Identifier for the dataset creation property list.
|
|
<dt><em>int</em> <code>level</code>
|
|
<dd>IN: Compression level.
|
|
</dl>
|
|
<dt><strong>Returns:</strong>
|
|
<dd>Returns a non-negative value if successful;
|
|
otherwise returns a negative value.
|
|
<dt><strong>Non-C API(s):</strong>
|
|
<dd><a href="fortran/h5p_FORTRAN.html#h5pset_deflate_f"
|
|
target="FortranWin"><img src="Graphics/FORTRAN.gif" border=0></a>
|
|
<!--
|
|
<img src="Graphics/Java.gif">
|
|
<img src="Graphics/C++.gif">
|
|
-->
|
|
</dl>
|
|
|
|
|
|
<!--
|
|
|
|
<hr>
|
|
<dl>
|
|
<dt><strong>Name:</strong> <a name="Property-GetDeflate">H5Pget_deflate</a>
|
|
<dt><strong>Signature:</strong>
|
|
<dd><em>int</em> <code>H5Pget_deflate</code>(<em>hid_t</em> <code>plist</code>
|
|
)
|
|
<dt><strong>Purpose:</strong>
|
|
<dd>Returns the deflate compression level from a dataset creation
|
|
property list.
|
|
<dt><strong>Description:</strong>
|
|
<dd><code>H5Pget_deflate</code> returns the deflate compression level
|
|
from a dataset creation property list that uses that method.
|
|
<dt><strong>Parameters:</strong>
|
|
<dl>
|
|
<dt><em>hid_t</em> <code>plist</code>
|
|
<dd>IN: Identifier for the dataset creation property list.
|
|
</dl>
|
|
<dt><strong>Returns:</strong>
|
|
<dd>Returns compression level, a value between 0 and 9, if successful.
|
|
Otherwise returns a negative value.
|
|
<dt><strong>Non-C API(s):</strong>
|
|
<dd><a href="fortran/h5p_FORTRAN.html#h5pxxx"
|
|
target="FortranWin"><img src="Graphics/FORTRAN.gif" border=0></a>
|
|
<img src="Graphics/Java.gif">
|
|
<img src="Graphics/C++.gif">
|
|
</dl>
|
|
|
|
-->
|
|
|
|
|
|
<hr>
|
|
<dl>
|
|
<dt><strong>Name:</strong> <a name="Property-SetVLMemManager">H5Pset_vlen_mem_manager</a>
|
|
<dt><strong>Signature:</strong>
|
|
<dd><em>herr_t</em> <code>H5Pset_vlen_mem_manager</code>(<em>hid_t</em> <code>plist</code>,
|
|
<em>H5MM_allocate_t</em> <code>alloc</code>,
|
|
<em>void</em> *<code>alloc_info</code>,
|
|
<em>H5MM_free_t</em> <code>free</code>,
|
|
<em>void</em> *<code>free_info</code>
|
|
)
|
|
<dt><strong>Purpose:</strong>
|
|
<dd>Sets the memory manager for variable-length datatype allocation in
|
|
<code>H5Dread</code> and <code>H5Dvlen_reclaim</code>.
|
|
<dt><strong>Description:</strong>
|
|
<dd><code>H5Pset_vlen_mem_manager</code> sets the memory manager for
|
|
variable-length datatype allocation in <code>H5Dread</code>
|
|
and free in <code>H5Dvlen_reclaim</code>.
|
|
<p>
|
|
The <code>alloc</code> and <code>free</code> parameters
|
|
identify the memory management routines to be used.
|
|
If the user has defined custom memory management routines,
|
|
<code>alloc</code> and/or <code>free</code> should be set to make
|
|
those routine calls (i.e., the name of the routine is used as
|
|
the value of the parameter);
|
|
if the user prefers to use the system's <code> malloc</code>
|
|
and/or <code>free</code>, the <code>alloc</code> and
|
|
<code>free</code> parameters, respectively, should be set to
|
|
<code> NULL</code>
|
|
<p>
|
|
The prototypes for these user-defined functions would appear as follows:
|
|
<br>
|
|
<em>typedef void</em> *(*<code>H5MM_allocate_t</code>)(<em>size_t</em> <code>size</code>,
|
|
<em>void</em> *<code>alloc_info</code>) ;
|
|
|
|
<br>
|
|
<em>typedef void</em> (*<code>H5MM_free_t</code>)(<em>void</em> *<code>mem</code>,
|
|
<em>void</em> *<code>free_info</code>) ;
|
|
<br>
|
|
The <code>alloc_info</code> and <code>free_info</code> parameters
|
|
can be used to pass along any required information to
|
|
the user's memory management routines.
|
|
<p>
|
|
In summary, if the user has defined custom memory management
|
|
routines, the name(s) of the routines are passed in the
|
|
<code>alloc</code> and <code>free</code> parameters and the
|
|
custom routines' parameters are passed in the
|
|
<code>alloc_info</code> and <code>free_info</code> parameters.
|
|
If the user wishes to use the system <code> malloc</code> and
|
|
<code>free</code> functions, the <code>alloc</code> and/or
|
|
<code>free</code> parameters are set to <code> NULL</code>
|
|
and the <code>alloc_info</code> and <code>free_info</code>
|
|
parameters are ignored.
|
|
<dt><strong>Parameters:</strong>
|
|
<dl>
|
|
<dt><em>hid_t</em> <code>plist</code>
|
|
<dd>IN: Identifier for the dataset transfer property list.
|
|
<dt><em>H5MM_allocate_t</em> <code>alloc</code>
|
|
<dd>IN: User's allocate routine, or <code> NULL</code>
|
|
for system <code> malloc</code>.
|
|
<dt><em>void</em> *<code>alloc_info</code>
|
|
<dd>IN: Extra parameter for user's allocation routine.
|
|
<br>
|
|
Contents are ignored if preceding parameter is
|
|
<code> NULL</code>.
|
|
<dt><em>H5MM_free_t</em> <code>free</code>
|
|
<dd>IN: User's free routine, or <code> NULL</code>
|
|
for system <code>free</code>.
|
|
<dt><em>void</em> *<code>free_info</code>
|
|
<dd>IN: Extra parameter for user's free routine.
|
|
<br>
|
|
Contents are ignored if preceding parameter is
|
|
<code> NULL</code>.
|
|
</dl>
|
|
<dt><strong>Returns:</strong>
|
|
<dd>Returns a non-negative value if successful;
|
|
otherwise returns a negative value.
|
|
<!--
|
|
<dt><strong>Non-C API(s):</strong>
|
|
<dd><a href="fortran/h5p_FORTRAN.html#h5pxxx"
|
|
target="FortranWin"><img src="Graphics/FORTRAN.gif" border=0></a>
|
|
--> <!--
|
|
<img src="Graphics/Java.gif">
|
|
<img src="Graphics/C++.gif">
|
|
-->
|
|
</dl>
|
|
|
|
|
|
<hr>
|
|
<dl>
|
|
<dt><strong>Name:</strong> <a name="Property-GetVLMemManager">H5Pget_vlen_mem_manager</a>
|
|
<dt><strong>Signature:</strong>
|
|
<dd><em>herr_t</em> <code>H5Pget_vlen_mem_manager</code>(<em>hid_t</em> <code>plist</code>,
|
|
<em>H5MM_allocate_t</em> *<code>alloc</code>,
|
|
<em>void</em> **<code>alloc_info</code>,
|
|
<em>H5MM_free_t</em> *<code>free</code>,
|
|
<em>void</em> **<code>free_info</code>
|
|
)
|
|
<dt><strong>Purpose:</strong>
|
|
<dd>Gets the memory manager for variable-length datatype allocation in
|
|
<code>H5Dread</code> and <code>H5Dvlen_reclaim</code>.
|
|
<dt><strong>Description:</strong>
|
|
<dd><code>H5Pget_vlen_mem_manager</code> is the companion function to
|
|
<code>H5Pset_vlen_mem_manager</code>, returning the parameters
|
|
set by that function.
|
|
<dt><strong>Parameters:</strong>
|
|
<dl>
|
|
<dt><em>hid_t</em> <code>plist</code>
|
|
<dd>IN: Identifier for the dataset transfer property list.
|
|
<dt><em>H5MM_allocate_t</em> <code>alloc</code>
|
|
<dd>OUT: User's allocate routine, or <code> NULL</code>
|
|
for system <code> malloc</code>.
|
|
<dt><em>void</em> *<code>alloc_info</code>
|
|
<dd>OUT: Extra parameter for user's allocation routine.
|
|
<br>
|
|
Contents are ignored if preceding parameter is
|
|
<code> NULL</code>.
|
|
<dt><em>H5MM_free_t</em> <code>free</code>
|
|
<dd>OUT: User's free routine, or <code> NULL</code> for
|
|
system <code>free</code>.
|
|
<dt><em>void</em> *<code>free_info</code>
|
|
<dd>OUT: Extra parameter for user's free routine.
|
|
<br>
|
|
Contents are ignored if preceding parameter is
|
|
<code> NULL</code>.
|
|
</dl>
|
|
<dt><strong>Returns:</strong>
|
|
<dd>Returns a non-negative value if successful;
|
|
otherwise returns a negative value.
|
|
<!--
|
|
<dt><strong>Non-C API(s):</strong>
|
|
<dd><a href="fortran/h5p_FORTRAN.html#h5pxxx"
|
|
target="FortranWin"><img src="Graphics/FORTRAN.gif" border=0></a>
|
|
--> <!--
|
|
<img src="Graphics/Java.gif">
|
|
<img src="Graphics/C++.gif">
|
|
-->
|
|
</dl>
|
|
|
|
|
|
<hr>
|
|
<center>
|
|
<table border=0 width=98%>
|
|
<tr><td valign=top align=left>
|
|
<a href="H5.intro.html">Introduction to HDF5</a> <br>
|
|
<a href="H5.user.html">HDF5 User Guide</a> <br>
|
|
<a href="index.html">Other HDF5 documents and links</a> <br>
|
|
<!--
|
|
<a href="Glossary.html">Glossary</a><br>
|
|
-->
|
|
</td>
|
|
<td valign=top align=right>
|
|
And in this document, the
|
|
<a href="RM_H5Front.html">HDF5 Reference Manual</a>
|
|
<br>
|
|
<a href="RM_H5.html">H5</a>
|
|
<a href="RM_H5A.html">H5A</a>
|
|
<a href="RM_H5D.html">H5D</a>
|
|
<a href="RM_H5E.html">H5E</a>
|
|
<a href="RM_H5F.html">H5F</a>
|
|
<a href="RM_H5G.html">H5G</a>
|
|
<a href="RM_H5I.html">H5I</a>
|
|
<br>
|
|
H5P
|
|
<a href="RM_H5R.html">H5R</a>
|
|
<a href="RM_H5RA.html">H5RA</a>
|
|
<a href="RM_H5S.html">H5S</a>
|
|
<a href="RM_H5T.html">H5T</a>
|
|
<a href="RM_H5Z.html">H5Z</a>
|
|
<a href="Tools.html">Tools</a>
|
|
</td></tr>
|
|
</table>
|
|
</center>
|
|
<hr>
|
|
|
|
|
|
<address>
|
|
<a href="mailto:hdfhelp@ncsa.uiuc.edu">HDF Help Desk</a>
|
|
|
|
<br>
|
|
Last modified: 13 July 2000
|
|
<br>
|
|
Describes HDF5 Version 1.3 (Unrelased development version. Dynamic.)
|
|
|
|
</body>
|
|
</html>
|
|
|