HDF5 FORTRAN Developer's Guide

## H5D (F90)

[ Top ] [ Modules ]

NAME

      H5D_PROVISIONAL

PURPOSE

      This file contains Fortran 90 interfaces for H5D functions. It contains
      the same functions as H5Dff_F03.f90 but excludes the Fortran 2003 functions
      and the interface listings. This file will be compiled instead of H5Dff_F03.f90
      if Fortran 2003 functions are not enabled.

NOTES

      (1) The maximum rank of an array allowed in Fortran is 7, therefore
      we only provide an interface for arrays up to and including rank 7.

      (2) Unfortunately we are using a generic interface and one of the factors
      used in determining the proper routine to select is that of the array
      rank being passed, therefore we can not create just one subroutine for
      each array type (integer, real, etc...) of various ranks and then use a
      rank 1 array of assumed size in the just one subroutine,
      (i.e. integer, dimension(*) :: ... )
      (i.e. real   , dimension(*) :: ... ) etc...

      (3)
                             *** IMPORTANT ***
      If you add a new H5D function you must add the function name to the
      Windows dll file 'hdf5_fortrandll.def' in the fortran/src directory.
      This is needed for Windows based operating systems.

## h5dread_f

[ Top ] [ H5D ] [ Subroutines ]

NAME

      h5dread_f

PURPOSE

      Reads raw data from the specified dataset into buf,
      converting from file datatype and dataspace to memory
      datatype and dataspace.

INPUTS

      dset_id       - dataset identifier
      mem_type_id   - memory type identifier
      dims          - 1-dim array of size 7; dims(k) has the size
                      of k-th dimension of the buf array

OUTPUTS

      buf     - buffer to read data in
      hdferr: - error code
                 Success:  0
                 Failure: -1

OPTIONAL PARAMETERS

      mem_space_id  - memory dataspace identifier
      file_space_id - file dataspace identifier
      xfer_prp      - trasfer property list identifier

AUTHOR

      Elena Pourmal
      August 12, 1999

HISTORY

      Explicit Fortran interfaces were added for
      called C functions (it is needed for Windows
      port).  February 28, 2001

      dims parameter was added to make code portable;
      n parameter was replaced with dims parameter in
      the h5dwrite_reference_obj and h5dwrite_reference_dsetreg
      functions.  April 2, 2001

NOTES

      This function is overloaded to read INTEGER,
      REAL, DOUBLE PRECISION and CHARACTER buffers
      up to 7 dimensions, and one dimensional buffers
      of the TYPE(hobj_ref_t_f) and TYPE(hdset_reg_ref_t_f) types.