MPIFilegetposition(3OpenMPI) MPIFilegetposition(3OpenMPI)

NAME
       MMPPIIFFiilleeggeettppoossiittiioonn  - Returns the current position of the individual
       file pointer.


SSYYNNTTAAXX
       C Syntax
           #include 
           int MPIFilegetposition(MPIFile fh, MPIOffset *offset)

       Fortran Syntax (see FORTRAN 77 NOTES)
           INCLUDE 'mpif.h'
           MPIFILEGETPOSITION(FH, OFFSET, IERROR)
                  INTEGER FH, IERROR
                  INTEGER(KIND=MPIOFFSETKIND) OFFSET


CC++++ SSyynnttaaxx
       #include 
       MPI::Offset MPI::File::Getposition() const


IINNPPUUTT PPAARRAAMMEETTEERR
       fh        File handle (handle).


OOUUTTPPUUTT PPAARRAAMMEETTEERRSS
       offset    Offset of the individual file pointer (integer).

       IERROR    Fortran only: Error status (integer).


DESCRIPTION
       MPIFilegetposition returns, in offset, the current position  of  the
       individual  file  pointer  in  etype units relative to the current dis-
       placement and file type.


FFOORRTTRRAANN 7777 NNOOTTEESS
       The MPI standard prescribes portable  Fortran  syntax  for  the  OFFSET
       argument only for Fortran 90. Sun FORTRAN 77 users may use the non-por-
       table syntax

            INTEGER*MPIOFFSETKIND OFFSET

       where MPIADDRESSKIND is a constant defined in mpif.h  and  gives  the
       length of the declared integer in bytes.


EERRRROORRSS
       Almost  all MPI routines return an error value; C routines as the value
       of the function and Fortran routines in the last  argument.  C++  func-
       tions  do  not  return  errors.  If the default error handler is set to
       MPI::ERRORSTHROWEXCEPTIONS, then on error the C++ exception mechanism
       will be used to throw an MPI:Exception object.

       Before  the  error  value is returned, the current MPI error handler is
       called. For MPI I/O function errors, the default error handler  is  set
       to   MPIERRORSRETURN.   The   error   handler  may  be  changed  with
       MPIFileseterrhandler;     the     predefined      error      handler
       MPIERRORSAREFATAL  may  be  used to make I/O errors fatal. Note that
       MPI does not guarantee that an MPI program can continue past an  error.




Open MPI 1.2                    September 2006 MPIFilegetposition(3OpenMPI)