summaryrefslogtreecommitdiffstats
path: root/doc/html/RM_H5R.html
diff options
context:
space:
mode:
authorFrank Baker <fbaker@hdfgroup.org>2003-10-21 22:18:46 (GMT)
committerFrank Baker <fbaker@hdfgroup.org>2003-10-21 22:18:46 (GMT)
commitbcce957f4b356e4739c1414191d24de5b8c8612a (patch)
treef1e95d9d0f06ac9b0793ae82bc06a3f4c658d692 /doc/html/RM_H5R.html
parentbc020e6b703fa1a2624cf6a0de019a3d6de07efa (diff)
downloadhdf5-bcce957f4b356e4739c1414191d24de5b8c8612a.zip
hdf5-bcce957f4b356e4739c1414191d24de5b8c8612a.tar.gz
hdf5-bcce957f4b356e4739c1414191d24de5b8c8612a.tar.bz2
[svn-r7691]
Description: Integrate Fortran90 function descriptions Remove "Non-C APIs" sections; add "Fortran90 Interface" sections Remove note that Fortran APIs are described in a separate window Platforms tested: Safari
Diffstat (limited to 'doc/html/RM_H5R.html')
-rw-r--r--doc/html/RM_H5R.html135
1 files changed, 107 insertions, 28 deletions
diff --git a/doc/html/RM_H5R.html b/doc/html/RM_H5R.html
index f838e75..cc08529 100644
--- a/doc/html/RM_H5R.html
+++ b/doc/html/RM_H5R.html
@@ -124,18 +124,10 @@ to specific objects and data regions in an HDF5 file.
<br>
<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 (electronic versions only) 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><br>
+In general, each FORTRAN90 subroutine performs exactly the same task
+as the corresponding C function.
+<br>
<table border=0 width=80%>
<tr><td valign=top width=40%>
@@ -219,10 +211,40 @@ facilitate moving easily between them.</i>
<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/h5r_FORTRAN.html#h5rcreate_f"
- target="FortranWin"><img src="Graphics/FORTRAN.gif" border=0></a>
- <!--
+<dt><strong>Fortran90 Interface:</strong> h5rcreate_f
+
+ <p><strong>To create an object reference</strong>
+ <dd>
+ <pre>
+SUBROUTINE h5rcreate_f(loc_id, name, ref, hdferr)
+ IMPLICIT NONE
+ INTEGER(HID_T), INTENT(IN) :: loc_id ! Location identifier
+ CHARACTER(LEN=*), INTENT(IN) :: name ! Name of the object at location
+ ! specified by loc_id identifier
+ TYPE(hobj_ref_t_f), INTENT(OUT) :: ref ! Object reference
+ INTEGER, INTENT(OUT) :: hdferr ! Error code
+
+END SUBROUTINE h5rcreate_f
+ </pre></dt>
+
+<dt><strong>To create a region reference</strong>
+ <dd>
+ <pre>
+SUBROUTINE h5rcreate_f(loc_id, name, space_id, ref, hdferr)
+ IMPLICIT NONE
+ INTEGER(HID_T), INTENT(IN) :: loc_id ! Location identifier
+ CHARACTER(LEN=*), INTENT(IN) :: name ! Name of the dataset at location
+ ! specified by loc_id identifier
+ INTEGER(HID_T), INTENT(IN) :: space_id ! Dataset's dataspace identifier
+ TYPE(hdset_reg_ref_t_f), INTENT(OUT) :: ref ! Dataset region reference
+ INTEGER, INTENT(OUT) :: hdferr ! Error code
+
+END SUBROUTINE h5rcreate_f
+ </pre>
+
+ <!--<dt><strong>Non-C API(s):</strong>
+ <dd>
+
<img src="Graphics/Java.gif">
<img src="Graphics/C++.gif">
-->
@@ -263,10 +285,38 @@ facilitate moving easily between them.</i>
<dt><strong>Returns:</strong>
<dd>Returns valid identifier if successful;
otherwise returns a negative value.
-<dt><strong>Non-C API(s):</strong>
- <dd><a href="fortran/h5r_FORTRAN.html#h5rdereference_f"
- target="FortranWin"><img src="Graphics/FORTRAN.gif" border=0></a>
- <!--
+<dt><strong>Fortran90 Interface:</strong> h5rdereference_f
+
+ <p><strong>To dereference an object</strong>
+ <dd>
+ <pre>
+SUBROUTINE h5rdereference_f(dset_id, ref, obj_id, hdferr)
+ IMPLICIT NONE
+ INTEGER(HID_T), INTENT(IN) :: dset_id ! Dataset identifier
+ TYPE(hobj_ref_t_f), INTENT(IN) :: ref ! Object reference
+ INTEGER(HID_T), INTENT(OUT) :: obj_id ! Object identifier
+ INTEGER, INTENT(OUT) :: hdferr ! Error code
+
+END SUBROUTINE h5rdereference_f
+ </pre>
+</dt>
+
+<dt><strong>To dereference a region</strong>
+ <dd>
+ <pre>
+SUBROUTINE h5rdereference_f(dset_id, ref, obj_id, hdferr)
+ IMPLICIT NONE
+ INTEGER(HID_T), INTENT(IN) :: dset_id ! Dataset identifier
+ TYPE(hdset_reg_ref_t_f), INTENT(IN) :: ref ! Object reference
+ INTEGER(HID_T), INTENT(OUT) :: obj_id ! Object identifier
+ INTEGER, INTENT(OUT) :: hdferr ! Error code
+
+END SUBROUTINE h5rdereference_f
+ </pre>
+
+ <!--<dt><strong>Non-C API(s):</strong>
+ <dd>
+
<img src="Graphics/Java.gif">
<img src="Graphics/C++.gif">
-->
@@ -336,10 +386,27 @@ facilitate moving easily between them.</i>
<dt><strong>Returns:</strong>
<dd>Returns an object type as defined in <code>H5Gpublic.h</code> if successful;
otherwise returns <code>H5G_UNKNOWN</code>.
-<dt><strong>Non-C API(s):</strong>
- <dd><a href="fortran/h5r_FORTRAN.html#h5rget_object_type_f"
- target="FortranWin"><img src="Graphics/FORTRAN.gif" border=0></a>
- <!--
+<dt><strong>Fortran90 Interface:</strong> h5rget_object_type_f
+ <dd>
+ <pre>
+SUBROUTINE h5rget_object_type_f(dset_id, ref, obj_type, hdferr)
+ IMPLICIT NONE
+ INTEGER(HID_T), INTENT(IN) :: dset_id ! Dataset identifier
+ TYPE(hobj_ref_t_f), INTENT(IN) :: ref ! Object reference
+ INTEGER, INTENT(OUT) :: obj_type ! Object type
+ ! H5G_UNKNOWN_F (-1)
+ ! H5G_LINK_F 0
+ ! H5G_GROUP_F 1
+ ! H5G_DATASET_F 2
+ ! H5G_TYPE_F 3
+ INTEGER, INTENT(OUT) :: hdferr ! Error code
+
+END SUBROUTINE h5rget_object_type_f
+ </pre>
+
+ <!--<dt><strong>Non-C API(s):</strong>
+ <dd>
+
<img src="Graphics/Java.gif">
<img src="Graphics/C++.gif">
-->
@@ -382,10 +449,22 @@ facilitate moving easily between them.</i>
<dt><strong>Returns:</strong>
<dd>Returns a valid identifier if successful;
otherwise returns a negative value.
-<dt><strong>Non-C API(s):</strong>
- <dd><a href="fortran/h5r_FORTRAN.html#h5rget_region_f"
- target="FortranWin"><img src="Graphics/FORTRAN.gif" border=0></a>
- <!--
+<dt><strong>Fortran90 Interface:</strong> h5rget_region_f
+ <dd>
+ <pre>
+SUBROUTINE h5rget_region_f(dset_id, ref, space_id, hdferr)
+ IMPLICIT NONE
+ INTEGER(HID_T), INTENT(IN) :: dset_id ! Dataset identifier
+ TYPE(hdset_reg_ref_t_f), INTENT(IN) :: ref ! Dataset region reference
+ INTEGER(HID_T), INTENT(OUT) :: space_id ! Space identifier
+ INTEGER, INTENT(OUT) :: hdferr ! Error code
+
+END SUBROUTINE h5rget_region_f
+ </pre>
+
+ <!--<dt><strong>Non-C API(s):</strong>
+ <dd>
+
<img src="Graphics/Java.gif">
<img src="Graphics/C++.gif">
-->
@@ -430,7 +509,7 @@ And in this document, the
Describes HDF5 Release 1.6.0, July 2003
</address><!-- #EndLibraryItem --><SCRIPT LANGUAGE="JAVASCRIPT">
<!--
-document.writeln("Last modified: 8 October 2003");
+document.writeln("Last modified: 21 October 2003");
-->
</SCRIPT>