./src/H5Dff_F90.f90

H5D (F90)

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.