From 09390d1fa733c9648cf34b7ea56ad4802571a00e Mon Sep 17 00:00:00 2001 From: Frank Baker Date: Mon, 2 Jul 2001 13:15:13 -0500 Subject: [svn-r4094] Purpose: Synchronizing R1.5 development branch fortran docs with R1.4.x release branch. Platforms tested: IE 5 --- doc/html/fortran/h5a_FORTRAN.html | 25 +++++++---- doc/html/fortran/h5d_FORTRAN.html | 88 +++++++++++++++++++++++++++++++++++---- doc/html/fortran/h5p_FORTRAN.html | 71 ++++++++++++++++++++----------- doc/html/fortran/h5r_FORTRAN.html | 19 ++++----- doc/html/fortran/h5t_FORTRAN.html | 11 ++++- 5 files changed, 163 insertions(+), 51 deletions(-) diff --git a/doc/html/fortran/h5a_FORTRAN.html b/doc/html/fortran/h5a_FORTRAN.html index d87cbc5..281fa38 100644 --- a/doc/html/fortran/h5a_FORTRAN.html +++ b/doc/html/fortran/h5a_FORTRAN.html @@ -235,14 +235,19 @@ FORTRAN Attribute API -- h5a
FORTRAN interface:   h5aread_f
 
-          SUBROUTINE h5aread_f(attr_id, memtype_id,  buf, hdferr) 
+          SUBROUTINE h5aread_f(attr_id, memtype_id,  buf, dims, hdferr) 
             IMPLICIT NONE
             INTEGER(HID_T), INTENT(IN) :: attr_id   ! Attribute identifier 
             INTEGER(HID_T), INTENT(IN) :: memtype_id ! Attribute datatype 
                                                      ! identifier  (in memory)
-            TYPE(VOID), INTENT(OUT) :: buf            ! Attribute data 
-            INTEGER, INTENT(OUT) :: hdferr       ! Error code
-                                                 ! 0 on success and -1 on failure
+            TYPE, INTENT(INOUT)  :: buf         ! Data buffer; may be a scalar or an array
+            INTEGER, INTENT(IN)  :: dims(7)     ! Array to hold corresponding
+                                                ! dimension sizes of data buffer buf;
+                                                ! dim(k) has value of the k-th dimension
+                                                ! of buffer buf;
+                                                ! values are ignored if buf is a scalar
+            INTEGER, INTENT(OUT) :: hdferr      ! Error code
+                                                ! 0 on success and -1 on failure
           END SUBROUTINE h5aread_f
 
@@ -259,12 +264,17 @@ FORTRAN Attribute API -- h5a
FORTRAN interface:   h5awrite_f
 
-          SUBROUTINE h5awrite_f(attr_id, memtype_id,  buf, hdferr) 
+          SUBROUTINE h5awrite_f(attr_id, memtype_id,  buf, dims, hdferr) 
             IMPLICIT NONE
             INTEGER(HID_T), INTENT(IN) :: attr_id   ! Attribute identifier 
             INTEGER(HID_T), INTENT(IN) :: memtype_id ! Attribute datatype 
                                                      ! identifier  (in memory)
-            TYPE(VOID), INTENT(IN) :: buf            ! Attribute data 
+            TYPE, INTENT(IN) :: buf             ! Data buffer; may be a scalar or an array
+            INTEGER, INTENT(IN)  :: dims(7)     ! Array to hold corresponding
+                                                ! dimension sizes of data buffer buf;
+                                                ! dim(k) has value of the k-th dimension
+                                                ! of buffer buf;
+                                                ! values are ignored if buf is a scalar
             INTEGER, INTENT(OUT) :: hdferr       ! Error code
                                                  ! 0 on success and -1 on failure
           END SUBROUTINE h5awrite_f
@@ -283,10 +293,9 @@ FORTRAN Attribute API -- h5a
 HDF Help Desk 
 
 
-Last modified:  20 October 1999
+Last modified:  29 June 2001
 
Describes HDF5 Release 1.5, Unreleased Development Branch - diff --git a/doc/html/fortran/h5d_FORTRAN.html b/doc/html/fortran/h5d_FORTRAN.html index 8a08e8d..5c141b5 100644 --- a/doc/html/fortran/h5d_FORTRAN.html +++ b/doc/html/fortran/h5d_FORTRAN.html @@ -162,10 +162,11 @@ FORTRAN Dataset API -- h5d
FORTRAN interface:   h5dopen_f
-          SUBROUTINE h5dopen_f(loc_id, name, hdferr) 
+          SUBROUTINE h5dopen_f(loc_id, name, dset_id, hdferr) 
             IMPLICIT NONE 
             INTEGER(HID_T), INTENT(IN) :: loc_id   ! File or group identifier
             CHARACTER(LEN=*), INTENT(IN) :: name   ! Name of the dataset 
+            INTEGER(HID_T), INTENT(OUT) :: dset_id ! Dataset identifier
             INTEGER, INTENT(OUT) :: hdferr       ! Error code 
                                                  ! 0 on success and -1 on failure
           END SUBROUTINE h5dopen_f  
@@ -182,15 +183,52 @@ FORTRAN Dataset API -- h5d
 
 
 
FORTRAN interface:   h5dread_f + (for all datatypes except object and dataset region references) +
+
+          SUBROUTINE h5dread_f(dset_id, mem_type_id, buf, dims, hdferr, &
+                               mem_space_id, file_space_id, xfer_prp)
+
+            IMPLICIT NONE
+            INTEGER(HID_T), INTENT(IN) :: dset_id   ! Dataset identifier
+            INTEGER(HID_T), INTENT(IN) :: mem_type_id ! Memory datatype identifier
+            TYPE, INTENT(INOUT) :: buf          ! Data buffer; may be a scalar or an array
+            INTEGER, INTENT(IN)  :: dims(7)     ! Array to hold corresponding
+                                                ! dimension sizes of data buffer buf;
+                                                ! dim(k) has value of the k-th dimension
+                                                ! of buffer buf;
+                                                ! values are ignored if buf is a scalar
+            INTEGER, INTENT(OUT) :: hdferr      ! Error code 
+                                                ! 0 on success and -1 on failure
+            INTEGER(HID_T), OPTIONAL, INTENT(IN) :: mem_space_id 
+                                                ! Memory dataspace identfier 
+                                                ! Default value is H5S_ALL_F 
+            INTEGER(HID_T), OPTIONAL, INTENT(IN) :: file_space_id 
+                                                ! File dataspace identfier 
+                                                ! Default value is H5S_ALL_F
+            INTEGER(HID_T), OPTIONAL, INTENT(IN) :: xfer_prp 
+                                                ! Transfer property list identifier 
+                                                ! Default value is H5P_DEFAULT_F 
+            
+          END SUBROUTINE h5dread_f
+
+ + +

  + + +

FORTRAN interface:   h5dread_f + (for object reference and dataset region reference datatypes)
 
-          SUBROUTINE h5dread_f(dset_id, mem_type_id, buf, hdferr, &
+          SUBROUTINE h5dread_f(dset_id, mem_type_id, buf, n, hdferr, &
                                mem_space_id, file_space_id, xfer_prp)
 
             IMPLICIT NONE
             INTEGER(HID_T), INTENT(IN) :: dset_id   ! Dataset identifier
             INTEGER(HID_T), INTENT(IN) :: mem_type_id ! Memory datatype identifier
-            TYPE, INTENT(IN) :: buf(*,...*)     ! Data buffer of rank k
+            TYPE, INTENT(INOUT) :: buf(*)       ! Data buffer of rank 1
+            TYPE, INTENT(IN) :: n               ! Buffer size, 1 dimension only
             INTEGER, INTENT(OUT) :: hdferr      ! Error code 
                                                 ! 0 on success and -1 on failure
             INTEGER(HID_T), OPTIONAL, INTENT(IN) :: mem_space_id 
@@ -217,15 +255,52 @@ FORTRAN Dataset API -- h5d
 
 
 
FORTRAN interface:   h5dwrite_f + (for all datatypes except object and dataset region references)
 
-          SUBROUTINE h5dwrite_f(dset_id, mem_type_id, buf, hdferr, &
+          SUBROUTINE h5dwrite_f(dset_id, mem_type_id, buf, dims, hdferr, &
                                 mem_space_id, file_space_id, xfer_prp)
 
             IMPLICIT NONE
             INTEGER(HID_T), INTENT(IN) :: dset_id   ! Dataset identifier
             INTEGER(HID_T), INTENT(IN) :: mem_type_id ! Memory datatype identifier
-            TYPE, INTENT(IN) :: buf(*,...*)     ! Data buffer of rank k
+            TYPE, INTENT(IN) :: buf             ! Data buffer; may be a scalar or an array
+            INTEGER, INTENT(IN)  :: dims(7)     ! Array to hold corresponding
+                                                ! dimension sizes of data buffer buf;
+                                                ! dim(k) has value of the k-th dimension
+                                                ! of buffer buf;
+                                                ! values are ignored if buf is a scalar
+            INTEGER, INTENT(OUT) :: hdferr      ! Error code 
+                                                ! 0 on success and -1 on failure
+            INTEGER(HID_T), OPTIONAL, INTENT(IN) :: mem_space_id 
+                                                ! Memory dataspace identfier 
+                                                ! Default value is H5S_ALL_F
+            INTEGER(HID_T), OPTIONAL, INTENT(IN) :: file_space_id 
+                                                ! File dataspace identfier 
+                                                ! Default value is H5S_ALL_F
+            INTEGER(HID_T), OPTIONAL, INTENT(IN) :: xfer_prp 
+                                                ! Transfer property list identifier 
+                                                ! Default value is H5P_DEFAULT_F 
+            
+          END SUBROUTINE h5dwrite_f
+
+ + +

  + + +

FORTRAN interface:   h5dwrite_f + (for object reference and dataset region reference datatypes) +
+
+          SUBROUTINE h5dwrite_f(dset_id, mem_type_id, buf, n, hdferr, &
+                                mem_space_id, file_space_id, xfer_prp)
+
+            IMPLICIT NONE
+            INTEGER(HID_T), INTENT(IN) :: dset_id   ! Dataset identifier
+            INTEGER(HID_T), INTENT(IN) :: mem_type_id ! Memory datatype identifier
+            TYPE, INTENT(IN) :: buf(*)          ! Data buffer of rank 1
+            TYPE, INTENT(IN) :: n               ! Buffer size, 1 dimension only
             INTEGER, INTENT(OUT) :: hdferr      ! Error code 
                                                 ! 0 on success and -1 on failure
             INTEGER(HID_T), OPTIONAL, INTENT(IN) :: mem_space_id 
@@ -254,10 +329,9 @@ FORTRAN Dataset API -- h5d
 HDF Help Desk 
 
 
-Last modified:  20 October 1999
+Last modified:  29 June 2001
 
Describes HDF5 Release 1.5, Unreleased Development Branch - diff --git a/doc/html/fortran/h5p_FORTRAN.html b/doc/html/fortran/h5p_FORTRAN.html index a0dfac8..c4caa04 100644 --- a/doc/html/fortran/h5p_FORTRAN.html +++ b/doc/html/fortran/h5p_FORTRAN.html @@ -508,6 +508,8 @@ FORTRAN Property List API -- h5p
+ + + + +

 

 


@@ -644,6 +657,8 @@ FORTRAN Property List API -- h5p
+ + + + +

 

 


@@ -1202,15 +1228,15 @@ FORTRAN Property List API -- h5p

 


  - +

  -

FORTRAN interface:   h5pset_mpi_f +
FORTRAN interface:   h5pset_fapl_mpi_f
 
-         SUBROUTINE h5pset_mpi_f(prp_id, comm, info, hdferr) 
+         SUBROUTINE h5pset_fapl_mpi_f(prp_id, comm, info, hdferr) 
             IMPLICIT NONE
             INTEGER(HID_T), INTENT(IN) :: prp_id ! Property list identifier
             INTEGER, INTENT(IN) :: comm ! MPI communicator to be used for file open
@@ -1218,7 +1244,7 @@ FORTRAN Property List API -- h5p
             INTEGER, INTENT(IN) :: info ! MPI info object to be used for file open
                                         ! as defined in MPI_FILE_OPEN of MPI-2
             INTEGER, INTENT(OUT) :: hdferr  ! Error code
-          END SUBROUTINE h5pset_mpi_f
+          END SUBROUTINE h5pset_fapl_mpi_f
 
@@ -1226,22 +1252,22 @@ FORTRAN Property List API -- h5p

 


  - +

  -

FORTRAN interface:   h5pget_mpi_f +
FORTRAN interface:   h5pget_fapl_mpi_f
 
-          SUBROUTINE h5pget_mpi_f(prp_id, comm, info, hdferr) 
+          SUBROUTINE h5pget_fapl_mpi_f(prp_id, comm, info, hdferr) 
             IMPLICIT NONE
             INTEGER(HID_T), INTENT(IN) :: prp_id ! Property list identifier
             INTEGER, INTENT(OUT) :: comm ! buffer to return communicator 
             INTEGER, INTENT(IN) :: info ! buffer to return info object 
                                         ! as defined in MPI_FILE_OPEN of MPI-2
             INTEGER, INTENT(OUT) :: hdferr  ! Error code
-          END SUBROUTINE h5pget_mpi_f
+          END SUBROUTINE h5pget_fapl_mpi_f
 
@@ -1249,23 +1275,22 @@ FORTRAN Property List API -- h5p

 


  - +

  -

FORTRAN interface:   h5pset_xfer_f +
FORTRAN interface:   h5pset_dxpl_mpi_f
 
-         SUBROUTINE h5pset_xfer_f(prp_id, data_xfer_mode, hdferr) 
+         SUBROUTINE h5pset_dxpl_mpi_f(prp_id, data_xfer_mode, hdferr) 
             IMPLICIT NONE
             INTEGER(HID_T), INTENT(IN) :: prp_id ! Property list identifier
             INTEGER, INTENT(IN) :: data_xfer_mode ! Data transfer mode. Possible values are:
-                                                  ! H5D_XFER_INDEPENDENT_F (0)
-                                                  ! H5D_XFER_COLLECTIVE_F  (1)
-                                                  ! H5D_XFER_DFLT_F        (2) 
+                                                  ! H5FD_MPIO_INDEPENDENT_F (0)
+                                                  ! H5FD_MPIO_COLLECTIVE_F  (1)
             INTEGER, INTENT(OUT) :: hdferr  ! Error code
-          END SUBROUTINE h5pset_xfer_f
+          END SUBROUTINE h5pset_dxpl_mpi_f
 
@@ -1273,23 +1298,22 @@ FORTRAN Property List API -- h5p

 


  - +

  -

FORTRAN interface:   h5pget_xfer_f +
FORTRAN interface:   h5pget_dxpl_mpi_f
 
-         SUBROUTINE h5pget_xfer_f(prp_id, data_xfer_mode, hdferr) 
+         SUBROUTINE h5pget_dxpl_mpi_f(prp_id, data_xfer_mode, hdferr) 
             IMPLICIT NONE
             INTEGER(HID_T), INTENT(IN) :: prp_id ! Property list identifier
             INTEGER, INTENT(OUT) :: data_xfer_mode ! Data transfer mode. Possible values are:
-                                                  ! H5D_XFER_INDEPENDENT_F (0)
-                                                  ! H5D_XFER_COLLECTIVE_F  (1)
-                                                  ! H5D_XFER_DFLT_F        (2) 
+                                                  ! H5FD_MPIO_INDEPENDENT_F (0)
+                                                  ! H5FD_MPIO_COLLECTIVE_F  (1)
             INTEGER, INTENT(OUT) :: hdferr  ! Error code
-          END SUBROUTINE h5pget_xfer_f 
+          END SUBROUTINE h5pget_dxpl_mpi_f 
 
@@ -1307,10 +1331,9 @@ FORTRAN Property List API -- h5p HDF Help Desk -Last modified: 17 July 2000 +Last modified: 19 February 2001
Describes HDF5 Release 1.5, Unreleased Development Branch - diff --git a/doc/html/fortran/h5r_FORTRAN.html b/doc/html/fortran/h5r_FORTRAN.html index a0ccae7..6758301 100644 --- a/doc/html/fortran/h5r_FORTRAN.html +++ b/doc/html/fortran/h5r_FORTRAN.html @@ -98,22 +98,22 @@ FORTRAN Reference API -- h5r

 


  - +

  -

FORTRAN interface:   h5rget_region_region_f +
FORTRAN interface:   h5rget_region_f
 
-          SUBROUTINE h5rget_region_region_f(dset_id, ref, space_id, hdferr) 
+          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_region_f
+          END SUBROUTINE h5rget_region_f
 
@@ -121,15 +121,15 @@ FORTRAN Reference API -- h5r

 


  - +

  -

FORTRAN interface:   h5rget_object_type_obj_f +
FORTRAN interface:   h5rget_object_type_f
 
-          SUBROUTINE h5rget_object_type_obj_f(dset_id, ref, obj_type, hdferr) 
+          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 
@@ -142,7 +142,7 @@ FORTRAN Reference API -- h5r
 
             INTEGER, INTENT(OUT) :: hdferr          ! Error code 
 
-          END SUBROUTINE h5rget_object_type_obj_f
+          END SUBROUTINE h5rget_object_type_f
 
@@ -158,10 +158,9 @@ FORTRAN Reference API -- h5r HDF Help Desk -Last modified: 13 July 2000 +Last modified: 3 April 2000
Describes HDF5 Release 1.5, Unreleased Development Branch - diff --git a/doc/html/fortran/h5t_FORTRAN.html b/doc/html/fortran/h5t_FORTRAN.html index 19343a5..fa7a7ca 100644 --- a/doc/html/fortran/h5t_FORTRAN.html +++ b/doc/html/fortran/h5t_FORTRAN.html @@ -877,6 +877,8 @@ FORTRAN Datatype API -- h5t
+ +

 

 


@@ -1002,6 +1006,8 @@ FORTRAN Datatype API -- h5t
+ +

 

  @@ -1217,10 +1225,9 @@ FORTRAN Datatype API -- h5t HDF Help Desk -Last modified: 14 July 2000 +Last modified: 19 February 2001
Describes HDF5 Release 1.5, Unreleased Development Branch - -- cgit v0.12