From 85cf3f4bb818f9de4497671b1816e63e2c338c38 Mon Sep 17 00:00:00 2001 From: Frank Baker Date: Thu, 22 Oct 1998 18:52:02 -0500 Subject: [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. --- doc/html/RM_H5F.html | 2 +- doc/html/RM_H5G.html | 144 ++------------------------------------------------- doc/html/RM_H5S.html | 10 ++-- 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.
Name: H5Fflush
Signature: -
herr_t H5Fis_hdf5(hid_t object_id +
herr_t H5Fflush(hid_t object_id )
Purpose:
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.               - -(NYI = Not yet implemented) @@ -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.

-Every file identifier returned by H5Fcreate or -H5Fopen maintains an independent current working group -stack, the top item of which is the current working group. The -stack can be manipulated with H5Gset, H5Gpush, -and H5Gpop. The root object is the current working group -if the stack is empty. - -

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.

-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 getcwd function would -then be trivial. +

@@ -182,118 +164,6 @@ then be trivial.
-
Name: H5Gset -
Signature: -
herr_t H5Gset (hid_t loc_id, - const char *name - ) -
Purpose: -
Sets the current working group within a file. -
Description: -
H5Gset 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. -

- loc_id can be a file identifier or a group identifier. -

- name 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 /Foo/Bar/Baz is - resolved by first looking up Foo in the root group; - the name Foo/Bar/Baz is resolved by first looking - up the name Foo in the current working group. -

- Each file identifier maintains its own notion of the current - working group. If loc_id is a group identifier, the - file identifier is derived from the group identifier. -

- If a single file is opened with multiple calls to H5Fopen(), - 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. -

Parameters: -
-
hid_t loc_id -
The file or group identifier. -
const char *name -
The name of the new current working group. -
-
Returns: -
Returns SUCCEED (0) if successful; - otherwise FAIL (-1). -
- - -
-
-
Name: H5Gpush -
Signature: -
herr_t H5Gpush (hid_t loc_id, - const char *name - ) -
Purpose: -
Sets the current working group by pushing a - new element onto the current working group stack. -
Description: -
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. H5Gpush pushes a new group - onto the stack, thus setting a new current working group. -
Parameters: -
-
hid_t loc_id -
File or group identifier. -
const char *name -
The name of the new current working group. The name may be - an absolute or relative name. -
-
Returns: -
Returns SUCCEED (0) if successful; - otherwise FAIL (-1). -
- - -
-
-
Name: H5Gpop -
Signature: -
herr_t H5Gpop (hid_t loc_id) -
Purpose: -
Removes the top, or latest, entry from the working group stack, - setting the current working group to the previous value. -
Description: -
H5Gpop 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. -

- Each file identfier maintains its own notion of the current - working group. That is, if a single file is opened with - multiple calls to H5Fopen(), which returns multiple file - handles, then each identfier's current working group can be - set independently of the other file identfiers for that file. -

- If loc_id is a group identifier, it is used only to determine the - file identifier for the stack from which to pop the top entry. -

Parameters: -
-
hid_t loc_id -
The file, group, dataset, or datatype identifier. -
-
Returns: -
Returns SUCCEED (0) if successful; - otherwise FAIL (-1). -
- - -
-
Name: H5Gclose
Signature:
herr_t H5Gclose(hid_t group_id) @@ -367,8 +237,6 @@ then be trivial.
Name: H5Gunlink -      - (Not implemented in this release.)
Signature:
herr_t H5Gunlink(hid_t loc_id, const char *name @@ -473,8 +341,6 @@ then be trivial.
Name: H5Gmove -      - (Not implemented in this release.)
Signature:
herr_t H5Gmove(hid_t loc_id, const char *src, 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.
  • H5Sget_simple_extent_dims
  • H5Sget_simple_extent_ndims
  • H5Sget_simple_extent_npoints -
  • H5Sget_space_type +
  • H5Sget_simple_extent_type       
      @@ -403,13 +403,13 @@ of the HDF5 User's Guide..
      -
      Name: H5Sget_space_type +
      Name: H5Sget_simple_extent_type
      Signature: -
      H5S_class_t H5Sget_space_type(hid_t space_id) +
      H5S_class_t H5Sget_simple_extent_type(hid_t space_id)
      Purpose:
      Determine the current class of a dataspace.
      Description: -
      H5Sget_space_type queries a dataspace to determine the +
      H5Sget_simple_extent_type queries a dataspace to determine the current class of a dataspace.

      The function returns a class name, one of the following: @@ -423,7 +423,7 @@ of the HDF5 User's Guide..

      Returns:
      Returns a dataspace class name if successful; - otherwise FAIL (-1). + otherwise H5S_NO_CLASS (-1).
    • -- cgit v0.12