diff options
| author | Frank Baker <fbaker@hdfgroup.org> | 1998-09-10 15:40:15 (GMT) |
|---|---|---|
| committer | Frank Baker <fbaker@hdfgroup.org> | 1998-09-10 15:40:15 (GMT) |
| commit | 750856c53aa1cae3217e853ab7571b20bc658ffc (patch) | |
| tree | 2ad244b7c01b98180e29883c74c87d4262ac1c62 /doc/src/RM_H5R.html | |
| parent | d07894304f4a608af828aee0a99dbb875fba1fa1 (diff) | |
| download | hdf5-750856c53aa1cae3217e853ab7571b20bc658ffc.zip hdf5-750856c53aa1cae3217e853ab7571b20bc658ffc.tar.gz hdf5-750856c53aa1cae3217e853ab7571b20bc658ffc.tar.bz2 | |
[svn-r684] RM_H5Front.html
Added link to Tools.html
Clean up formatting.
Added RM_H5R.html, Ragged Arrays, but link is commented out for Beta.
RM_H5.html
H5version Removed patch number parameter.
H5check_version Removed patch number parameter.
Corrected datatype to unsigned (was unsigned *).
Added missing "Purpose:" statement.
RM_H5A.html
H5Aread/write Added reference to data conversion limitations.
RM_H5D.html
H5Dwrite Added "Writing to an external dataset will fail
if the HDF5 file is not open for writing."
H5Dread/write Added reference to data conversion limitations.
RM_H5F.html
H5Fflush Added H5Fflush.
RM_H5G.html
H5Gget_stat Fixed formatting error.
Added mtime to the description of the data structure.
Added the following "Note:", per Robb's checkin mesage:
"Some systems will be able to record the time
accurately but unable to retrieve the correct time;
such systems (e.g., Irix64) will report an mtime
value of 0 (zero)."
Corrected successful return value.
H5Gset_comment Added the following statement to "Description:"
"Comments can be attached to any object that
has an object header, e.g., data sets, groups,
named data types, and data spaces,
but not symbolic links.
RM_H5P.html
Cleaned up file formatting.
H5Pset_filter Added these three functions.
H5Pget_nfilters
H5Pget_filter
H5Pget_deflate Removed these three functions. (Actually,
H5Pset_compression they are commented out, in case they should
H5Pget_compression be reinstated.)
RM_H5R.html
Intial version of H5R reference manual entry, but still largely
just a template.
Not yet ready for distribution.
Links to this document are currently commented out.
RM_H5S.html
H5S_set_extent_simple Changed name to H5Sselect_extent_simple.
now: H5Sselect_extent_simpl
H5Sselect_npoints Corrected return value.
Now: H5Sget_select_npoints
H5Sget_class Reinstated to RM. Changed name.
now: H5Sget_space_type
H5Soffset_simple Added these 6 functions. The there is a
H5Sextent_copy link to Dataspaces.html for the 10 "not yet
H5Sset_extent_none implemented (NYI)" functions.
H5Sselect_all
H5Sselect_none
H5Sselect_valid
RM_H5T.html
Added the following datatypes (though the list of native datatypes
is commented out):
H5T_NATIVE_HSIZE
H5T_NATIVE_HSSIZE
H5T_NATIVE_HERR
H5T_NATIVE_HBOOL
Tools.html
Corrected h5ls and h5repart sections.
Glossary.html
Unlinked for Beta.
Copyright.html
New file.
Copyright statement, linked into User's Guide and Reference Manual.
General
Changed the following function names:
From: To:
H5version H5get_libversion
H5vers_check H5check_version
H5Anum_attrs H5Aget_num_attrs
H5Fget_create_template H5Fget_create_plist
H5Fget_access_template H5Fget_access_plist
And associated "template" -> "property list" edits.
H5Gstat H5Gget_stat
H5Sextent_npoints H5Sget_simple_extent_npoints
H5Sextent_ndims H5Sget_simple_extent_ndims
H5Sextent_dims H5Sget_simple_extent_dims
H5Sget_class H5Sget_simple_extent_type
H5Sselect_npoints H5Sget_select_npoints
Added links to Tools.html and RM_H5R.html (Ragged Arrays),
though link to RM_H5R.html is commented out for now.
Diffstat (limited to 'doc/src/RM_H5R.html')
| -rw-r--r-- | doc/src/RM_H5R.html | 248 |
1 files changed, 248 insertions, 0 deletions
diff --git a/doc/src/RM_H5R.html b/doc/src/RM_H5R.html new file mode 100644 index 0000000..4e1fd7c --- /dev/null +++ b/doc/src/RM_H5R.html @@ -0,0 +1,248 @@ +<html> +<head><title> +HDF5/H5R Draft API Specification +</title></head> + +<body> + +<hr> +<center> +<a href="RM_H5Front.html">HDF5 Reference Manual</a> +<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_H5P.html">H5P</a> +H5R +<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> +<!-- +<a href="Glossary.html">Glossary</a> +--> +</center> +<hr> + +<center> +<h1>H5R: Ragged Array Interface</h1> +</center> + +<h2>Ragged Array API Functions</h2> +<table border=1> +<tr><th align=left> +<font color=red> +The H5R Interface is strictly experimental at this time; +the interface may change dramatically or support for ragged arrays +may be unavailable in future in releases. As a result, future releases +may be unable to retrieve data stored with this interface. +<p><center>Use these functions at your own risk!<br> +Do not create any archives using this interface!</center> +</font> +</th></tr> +</table> +<p> +These functions enable the user to store and retrieve data in ragged arrays. + + +<table border=0> +<tr><td valign=top> +<ul> + <li><a href="#Ragged-Create">H5Rcreate</a> + <li><a href="#Ragged-Open">H5Ropen</a> + <li><a href="#Ragged-Close">H5Rclose</a> +</ul> +</td><td> </td><td valign=top> +<ul> + <li><a href="#Ragged-Write">H5Rwrite</a> + <li><a href="#Ragged-Read">H5Rread</a> +</ul> +</td></tr> +</table> + +<p> + + + +<hr> +<dl> +<dt><strong>Name:</strong> <a name="Ragged-Create">H5Rcreate</a> +<dt><strong>Signature:</strong> + <dd><em> </em> <code>H5Rcreate</code>(<em> </em> <code> </code>, + <em> </em> <code> </code>, + <em> </em> <code> </code> + ) +<dt><strong>Purpose:</strong> + <dd> +<dt><strong>Description:</strong> + <dd><code>H5Rcreate</code> +<dt><strong>Parameters:</strong> + <dl> + <dt><em> </em> <code> </code> + <dd> + <dt><em> </em> <code> </code> + <dd> + <dt><em> </em> <code> </code> + <dd> + </dl> +<dt><strong>Returns:</strong> + <dd>Returns SUCCEED (0) if successful; + otherwise FAIL (-1). +</dl> + + +<hr> +<dl> +<dt><strong>Name:</strong> <a name="Ragged-Open">H5Ropen</a> +<dt><strong>Signature:</strong> + <dd><em> </em> <code>H5Ropen</code>(<em> </em> <code> </code>, + <em> </em> <code> </code>, + <em> </em> <code> </code> + ) +<dt><strong>Purpose:</strong> + <dd> +<dt><strong>Description:</strong> + <dd><code>H5Ropen</code> +<dt><strong>Parameters:</strong> + <dl> + <dt><em> </em> <code> </code> + <dd> + <dt><em> </em> <code> </code> + <dd> + <dt><em> </em> <code> </code> + <dd> + </dl> +<dt><strong>Returns:</strong> + <dd>Returns SUCCEED (0) if successful; + otherwise FAIL (-1). +</dl> + + +<hr> +<dl> +<dt><strong>Name:</strong> <a name="Ragged-Close">H5Rclose</a> +<dt><strong>Signature:</strong> + <dd><em> </em> <code>H5Rclose</code>(<em> </em> <code> </code>, + <em> </em> <code> </code>, + <em> </em> <code> </code> + ) +<dt><strong>Purpose:</strong> + <dd> +<dt><strong>Description:</strong> + <dd><code>H5Rclose</code> +<dt><strong>Parameters:</strong> + <dl> + <dt><em> </em> <code> </code> + <dd> + <dt><em> </em> <code> </code> + <dd> + <dt><em> </em> <code> </code> + <dd> + </dl> +<dt><strong>Returns:</strong> + <dd>Returns SUCCEED (0) if successful; + otherwise FAIL (-1). +</dl> + + +<hr> +<dl> +<dt><strong>Name:</strong> <a name="Ragged-Write">H5Rwrite</a> +<dt><strong>Signature:</strong> + <dd><em> </em> <code>H5Rwrite</code>(<em> </em> <code> </code>, + <em> </em> <code> </code>, + <em> </em> <code> </code> + ) +<dt><strong>Purpose:</strong> + <dd> +<dt><strong>Description:</strong> + <dd><code>H5Rwrite</code> + <p> + Datatype conversion takes place at the time of a read or write + and is automatic. See the + <a href="Datatypes.html#Datatypes-DataConversion">Data Conversion</a> + section of <cite>The Data Type Interface (H5T)</cite> in the + <cite>HDF5 User's Guide</cite> for a discussion of + data conversion, including the range of conversions currently + supported by the HDF5 libraries. +<dt><strong>Parameters:</strong> + <dl> + <dt><em> </em> <code> </code> + <dd> + <dt><em> </em> <code> </code> + <dd> + <dt><em> </em> <code> </code> + <dd> + </dl> +<dt><strong>Returns:</strong> + <dd>Returns SUCCEED (0) if successful; + otherwise FAIL (-1). +</dl> + + +<hr> +<dl> +<dt><strong>Name:</strong> <a name="Ragged-Read">H5Rread</a> +<dt><strong>Signature:</strong> + <dd><em> </em> <code>H5Rread</code>(<em> </em> <code> </code>, + <em> </em> <code> </code>, + <em> </em> <code> </code> + ) +<dt><strong>Purpose:</strong> + <dd> +<dt><strong>Description:</strong> + <dd><code>H5Rread</code> + <p> + Datatype conversion takes place at the time of a read or write + and is automatic. See the + <a href="Datatypes.html#Datatypes-DataConversion">Data Conversion</a> + section of <cite>The Data Type Interface (H5T)</cite> in the + <cite>HDF5 User's Guide</cite> for a discussion of + data conversion, including the range of conversions currently + supported by the HDF5 libraries. +<dt><strong>Parameters:</strong> + <dl> + <dt><em> </em> <code> </code> + <dd> + <dt><em> </em> <code> </code> + <dd> + <dt><em> </em> <code> </code> + <dd> + </dl> +<dt><strong>Returns:</strong> + <dd>Returns SUCCEED (0) if successful; + otherwise FAIL (-1). +</dl> + + +<hr> +<center> +<a href="RM_H5Front.html">HDF5 Reference Manual</a> +<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_H5P.html">H5P</a> +H5R +<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> +<!-- +<a href="Glossary.html">Glossary</a> +--> +</center> +<hr> + +<address> +<a href="mailto:hdfhelp@ncsa.uiuc.edu">HDF Help Desk</a> + +<br> +Last modified: 1 September 1998 + +</body> +</html> |