[svn-r2427] RM_H5T.html

H5Tvlen_create: Added cross-reference to H5Dget_vlen_buf_size
	    and H5Dvlen_reclaim.
 	H5Tget_class:  Removed numbers from class identifiers list.
	    Added H5T_VLEN to class identifiers list.
RM_H5F.html
	H5Freopen: Corrected description of file_id parameter.
	    Added comment about eventually closing returned identifier.
	    Added clarification that function cannot open closed files.
This commit is contained in:
Frank Baker 2000-07-06 11:31:40 -05:00
parent 031768b5e2
commit 56289a2c10
2 changed files with 29 additions and 15 deletions

View File

@ -557,22 +557,32 @@ facilitate moving easily between them.</i>
<dl>
<dt><strong>Name:</strong> <a name="File-Reopen">H5Freopen</a>
<dt><strong>Signature:</strong>
<dd><em>hid__t </em><code>H5Freopen</code>(<em>hid_t</em> <code>file_id</code>
<dd><em>hid_t </em><code>H5Freopen</code>(<em>hid_t</em> <code>file_id</code>
)
<dt><strong>Purpose:</strong>
<dd>Reopens an HDF5 file.
<dd>Returns a new identifier for a previously-opened HDF5 file.
<dt><strong>Description:</strong>
<dd><code>H5Freopen</code> reopens an HDF5 file. The new
file identifier which is returned points to the same file
as the specified file idetifier, <code>file_id</code>.
<dd><code>H5Freopen</code> returns a new file identifier for an
already-open HDF5 file, as specified by <code>file_id</code>.
Both identifiers share caches and other information.
The only difference between the identifiers is that the
new identifier is not mounted anywhere and no files are
mounted on it.
<p>
Note that there is no circumstance under which
<code>H5Freopen</code> can actually open a closed file;
the file must already be open and have an active
<code>file_id</code>. E.g., one cannot close a file with
<code> H5Fclose&nbsp;(file_id) </code> then use
<code> H5Freopen&nbsp;(file_id) </code> to reopen it.
<p>
The new file identifier should be closed by calling
<code>H5Fclose()</code> when it is no longer needed.
<dt><strong>Parameters:</strong>
<dl>
<dt><em>hid_t</em> <code>file_id</code>
<dd>Identifier of a file to terminate access to.
<dd>Identifier of a file for which an additional identifier
is required.
</dl>
<dt><strong>Returns:</strong>
<dd>Returns a new file identifier if successful;

View File

@ -684,6 +684,9 @@ H5Tget_overflow ()
<dt><em>hid_t</em> <code>base_type_id</code>
<dd>Base type of datatype to create.
</dl>
<dt><strong>See Also:</strong>
<dd><a href="RM_H5D.html#Dataset-GetVLBuf">H5Dget_vlen_buf_size</a>
<dd><a href="RM_H5D.html#Dataset-VLReclaim">H5Dvlen_reclaim</a>
<dt><strong>Returns:</strong>
<dd>Returns datatype identifier if successful;
otherwise returns a negative value.
@ -873,15 +876,16 @@ H5Tget_overflow ()
<dd><code>H5Tget_class</code> returns the datatype class identifier.
<p>
Valid class identifiers, as defined in <code>H5Tpublic.h</code>, are:
<ul><li><code>H5T_INTEGER</code> (<code>0</code>)
<li><code>H5T_FLOAT</code> (<code>1</code>)
<li><code>H5T_TIME</code> (<code>2</code>)
<li><code>H5T_STRING</code> (<code>3</code>)
<li><code>H5T_BITFIELD</code> (<code>4</code>)
<li><code>H5T_OPAQUE</code> (<code>5</code>)
<li><code>H5T_COMPOUND</code> (<code>6</code>)
<li><code>H5T_REFERENCE</code> (<code>7</code>)
<li><code>H5T_ENUM</code> (<code>8</code>)
<ul><li><code>H5T_INTEGER</code>
<li><code>H5T_FLOAT</code>
<li><code>H5T_TIME</code>
<li><code>H5T_STRING</code>
<li><code>H5T_BITFIELD</code>
<li><code>H5T_OPAQUE</code>
<li><code>H5T_COMPOUND</code>
<li><code>H5T_REFERENCE</code>
<li><code>H5T_ENUM</code>
<li><code>H5T_VLEN</code>
</ul>
<dt><strong>Parameters:</strong>
<dl>