summaryrefslogtreecommitdiffstats
path: root/doc
diff options
context:
space:
mode:
authorFrank Baker <fbaker@hdfgroup.org>1998-10-22 23:52:02 (GMT)
committerFrank Baker <fbaker@hdfgroup.org>1998-10-22 23:52:02 (GMT)
commit85cf3f4bb818f9de4497671b1816e63e2c338c38 (patch)
tree2348cab71779d8e0747554422f69683de38842d8 /doc
parent671ed571239ccad6c86918dfe04580c73d1b130e (diff)
downloadhdf5-85cf3f4bb818f9de4497671b1816e63e2c338c38.zip
hdf5-85cf3f4bb818f9de4497671b1816e63e2c338c38.tar.gz
hdf5-85cf3f4bb818f9de4497671b1816e63e2c338c38.tar.bz2
[svn-r777] RM_H5S.html
Changed H5Sget_space_type to H5Sget_simple_extent_type. Changed H5Sget_simple_extent_type FAIL return value to H5S_NO_CLASS. RM_H5F.html H5Fflush. Corrected function name in sytax line, which had read H5Fis_hdf. RM_H5G.html Removed discussion of "current working group" and associated information from the introductory discussion. H5Gset, H5Gpush, H5Gpop Removed these functions. H5Gunlink, H5Gmove Removed the "not yet implemented" notations from these functions.
Diffstat (limited to 'doc')
-rw-r--r--doc/html/RM_H5F.html2
-rw-r--r--doc/html/RM_H5G.html144
-rw-r--r--doc/html/RM_H5S.html10
3 files changed, 11 insertions, 145 deletions
diff --git a/doc/html/RM_H5F.html b/doc/html/RM_H5F.html
index 5ecc148..a242e2a 100644
--- a/doc/html/RM_H5F.html
+++ b/doc/html/RM_H5F.html
@@ -174,7 +174,7 @@ documented below.
<dl>
<dt><strong>Name:</strong> <a name="File-Flush">H5Fflush</a>
<dt><strong>Signature:</strong>
- <dd><em>herr_t </em><code>H5Fis_hdf5</code>(<em>hid_t </em><code>object_id</code>
+ <dd><em>herr_t </em><code>H5Fflush</code>(<em>hid_t </em><code>object_id</code>
)
<dt><strong>Purpose:</strong>
<dd>Flushes all buffers associated with a file to disk.
diff --git a/doc/html/RM_H5G.html b/doc/html/RM_H5G.html
index 9b0a8a0..1e79039 100644
--- a/doc/html/RM_H5G.html
+++ b/doc/html/RM_H5G.html
@@ -39,17 +39,14 @@ of objects on disk.
<ul>
<li><a href="#Group-Create">H5Gcreate</a>
<li><a href="#Group-Open">H5Gopen</a>
- <li><a href="#Group-Set">H5Gset</a>
<li><a href="#Group-Close">H5Gclose</a>
- <li><a href="#Group-Push">H5Gpush</a>
</ul>
</td><td>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</td><td valign=top>
<ul>
- <li><a href="#Group-Pop">H5Gpop</a>
<li><a href="#Group-Link">H5Glink</a>
- <li><a href="#Group-Unlink">H5Gunlink</a> (NYI)
+ <li><a href="#Group-Unlink">H5Gunlink</a>
<li><a href="#Group-Iterate">H5Giterate</a>
- <li><a href="#Group-Move">H5Gmove</a> (NYI)
+ <li><a href="#Group-Move">H5Gmove</a>
</ul>
</td><td>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</td><td valign=top>
<ul>
@@ -58,8 +55,6 @@ of objects on disk.
<li><a href="#Group-SetComment">H5Gset_comment</a>
<li><a href="#Group-GetComment">H5Gget_comment</a>
</ul>
-</td></tr><tr><td colspan=5 align=right>
-<font size=-2>(NYI = Not yet implemented)</font>
</td></tr>
</table>
@@ -76,29 +71,16 @@ non-empty file is the root object. The root object always has a
positive in-degree because it is pointed to by the file boot block.
<p>
-Every file identifier returned by <code>H5Fcreate</code> or
-<code>H5Fopen</code> maintains an independent current working group
-stack, the top item of which is the current working group. The
-stack can be manipulated with <code>H5Gset</code>, <code>H5Gpush</code>,
-and <code>H5Gpop</code>. The root object is the current working group
-if the stack is empty.
-
-<p>
An object name consists of one or more components separated from
one another by slashes. An absolute name begins with a slash and the
object is located by looking for the first component in the root
object, then looking for the second component in the first object, etc.,
until the entire name is traversed. A relative name does not begin
-with a slash and the traversal begins with the current working group.
+with a slash and the traversal begins at the location specified by the
+calling function.
<p>
-The library does not maintain the full absolute name of its current
-working group because (1) cycles in the graph can make the name length
-unbounded and (2) a group does not necessarily have a unique name. A
-more Unix-like hierarchical naming scheme can be implemented on top of
-the directed graph scheme by creating a ".." entry in each group that
-points to its single predecessor; a <code>getcwd</code> function would
-then be trivial.
+
<hr>
<dl>
@@ -182,118 +164,6 @@ then be trivial.
<hr>
<dl>
- <dt><strong>Name:</strong> <a name="Group-Set">H5Gset</a>
- <dt><strong>Signature:</strong>
- <dd><em>herr_t </em><code>H5Gset</code> (<em>hid_t</em> <code>loc_id</code>,
- <em>const char *</em><code>name</code>
- )
- <dt><strong>Purpose:</strong>
- <dd>Sets the current working group within a file.
- <dt><strong>Description:</strong>
- <dd><code>H5Gset</code> sets the group with the specified name
- to be the current working group for the file which contains it.
- This function sets the current working group by modifying the
- top element of the current working group stack or, if the
- stack is empty, by pushing a new element onto the stack.
- The initial current working group is the root group.
- <p>
- <code>loc_id</code> can be a file identifier or a group identifier.
- <p>
- <code>name</code> is an absolute or relative name and is resolved as follows. Each file identifier
- has a current working group, initially the root group of the
- file. Relative names do not begin with a slash and are relative
- to the specified group or to the current working group.
- Absolute names begin with a slash and are relative to the file's
- root group. For instance, the name <code>/Foo/Bar/Baz</code> is
- resolved by first looking up <code>Foo</code> in the root group;
- the name <code>Foo/Bar/Baz</code> is resolved by first looking
- up the name <code>Foo</code> in the current working group.
- <p>
- Each file identifier maintains its own notion of the current
- working group. If <code>loc_id</code> is a group identifier, the
- file identifier is derived from the group identifier.
- <p>
- If a single file is opened with multiple calls to <code>H5Fopen()</code>,
- which would return multiple file identifiers, then each
- identifier's current working group can be set independently
- of the other file identifiers for that file.
- <dt><strong>Parameters:</strong>
- <dl>
- <dt><em>hid_t</em> <code>loc_id</code>
- <dd>The file or group identifier.
- <dt><em>const char *</em><code>name</code>
- <dd>The name of the new current working group.
- </dl>
- <dt><strong>Returns:</strong>
- <dd>Returns SUCCEED (0) if successful;
- otherwise FAIL (-1).
-</dl>
-
-
-<hr>
-<dl>
- <dt><strong>Name:</strong> <a name="Group-Push">H5Gpush</a>
- <dt><strong>Signature:</strong>
- <dd><em>herr_t </em><code>H5Gpush</code> (<em>hid_t</em> <code>loc_id</code>,
- <em>const char *</em><code>name</code>
- )
- <dt><strong>Purpose:</strong>
- <dd>Sets the current working group by pushing a
- new element onto the current working group stack.
- <dt><strong>Description:</strong>
- <dd>Each file identifier maintains a stack of groups, the top group
- of which is the current working group. The stack initially
- contains only the root group. <code>H5Gpush</code> pushes a new group
- onto the stack, thus setting a new current working group.
- <dt><strong>Parameters:</strong>
- <dl>
- <dt><em>hid_t</em> <code>loc_id</code>
- <dd>File or group identifier.
- <dt><em>const char *</em><code>name</code>
- <dd>The name of the new current working group. The name may be
- an absolute or relative name.
- </dl>
- <dt><strong>Returns:</strong>
- <dd>Returns SUCCEED (0) if successful;
- otherwise FAIL (-1).
-</dl>
-
-
-<hr>
-<dl>
- <dt><strong>Name:</strong> <a name="Group-Pop">H5Gpop</a>
- <dt><strong>Signature:</strong>
- <dd><em>herr_t </em><code>H5Gpop</code> (<em>hid_t</em> <code>loc_id</code>)
- <dt><strong>Purpose:</strong>
- <dd>Removes the top, or latest, entry from the working group stack,
- setting the current working group to the previous value.
- <dt><strong>Description:</strong>
- <dd><code>H5Gpop</code> restores the previous current working group by
- popping an element from the current working group stack.
- An empty stack implies that the current working group is the root
- object. Attempting to pop an empty stack results in failure.
- <p>
- Each file identfier maintains its own notion of the current
- working group. That is, if a single file is opened with
- multiple calls to <code>H5Fopen()</code>, which returns multiple file
- handles, then each identfier's current working group can be
- set independently of the other file identfiers for that file.
- <p>
- If <code>loc_id</code> is a group identifier, it is used only to determine the
- file identifier for the stack from which to pop the top entry.
- <dt><strong>Parameters:</strong>
- <dl>
- <dt><em>hid_t</em> <code>loc_id</code>
- <dd>The file, group, dataset, or datatype identifier.
- </dl>
- <dt><strong>Returns:</strong>
- <dd>Returns SUCCEED (0) if successful;
- otherwise FAIL (-1).
-</dl>
-
-
-<hr>
-<dl>
<dt><strong>Name:</strong> <a name="Group-Close">H5Gclose</a>
<dt><strong>Signature:</strong>
<dd><em>herr_t </em><code>H5Gclose</code>(<em>hid_t </em><code>group_id</code>)
@@ -367,8 +237,6 @@ then be trivial.
<hr>
<dl>
<dt><strong>Name:</strong> <a name="Group-Unlink">H5Gunlink</a>
- &nbsp;&nbsp;&nbsp;&nbsp;
- <strong>(Not implemented in this release.)</strong>
<dt><strong>Signature:</strong>
<dd><em>herr_t </em><code>H5Gunlink</code>(<em>hid_t</em> <code>loc_id</code>,
<em>const char *</em><code>name</code>
@@ -473,8 +341,6 @@ then be trivial.
<hr>
<dl>
<dt><strong>Name:</strong> <a name="Group-Move">H5Gmove</a>
- &nbsp;&nbsp;&nbsp;&nbsp;
- <strong>(Not implemented in this release.)</strong>
<dt><strong>Signature:</strong>
<dd><em>herr_t</em> <code>H5Gmove</code>(<em>hid_t</em> <code>loc_id</code>,
<em>const char</em> <code>*src</code>,
diff --git a/doc/html/RM_H5S.html b/doc/html/RM_H5S.html
index ae69b20..d0ed17a 100644
--- a/doc/html/RM_H5S.html
+++ b/doc/html/RM_H5S.html
@@ -53,7 +53,7 @@ elements of a dataset.
<li><a href="#Dataspace-ExtentDims">H5Sget_simple_extent_dims</a>
<li><a href="#Dataspace-ExtentNdims">H5Sget_simple_extent_ndims</a>
<li><a href="#Dataspace-ExtentNpoints">H5Sget_simple_extent_npoints</a>
- <li><a href="#Dataspace-GetSpaceType">H5Sget_space_type</a>
+ <li><a href="#Dataspace-ExtentType">H5Sget_simple_extent_type</a>
</ul>
</td><td>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</td><td valign=top>
<ul>
@@ -403,13 +403,13 @@ of the <cite>HDF5 User's Guide.</cite>.
<hr>
<dl>
-<dt><strong>Name:</strong> <a name="Dataspace-GetSpaceType">H5Sget_space_type</a>
+<dt><strong>Name:</strong> <a name="Dataspace-ExtentType">H5Sget_simple_extent_type</a>
<dt><strong>Signature:</strong>
- <dd><em>H5S_class_t</em> <code>H5Sget_space_type</code>(<em>hid_t</em> <code>space_id</code>)
+ <dd><em>H5S_class_t</em> <code>H5Sget_simple_extent_type</code>(<em>hid_t</em> <code>space_id</code>)
<dt><strong>Purpose:</strong>
<dd>Determine the current class of a dataspace.
<dt><strong>Description:</strong>
- <dd><code>H5Sget_space_type</code> queries a dataspace to determine the
+ <dd><code>H5Sget_simple_extent_type</code> queries a dataspace to determine the
current class of a dataspace.
<p>
The function returns a class name, one of the following:
@@ -423,7 +423,7 @@ of the <cite>HDF5 User's Guide.</cite>.
</dl>
<dt><strong>Returns:</strong>
<dd>Returns a dataspace class name if successful;
- otherwise FAIL (-1).
+ otherwise H5S_NO_CLASS (-1).
</dl>