MPIWintest(3OpenMPI) MPIWintest(3OpenMPI)

NAME
       MMPPIIWWiinntteesstt  - Attempts to complete an RMA exposure epoch; a nonblock-
       ing version of MPIWinwait


SSYYNNTTAAXX
CC SSyynnttaaxx
       #include 
       int MPIWintest(MPIWin win, int *flag)


FFoorrttrraann SSyynnttaaxx
       INCLUDE 'mpif.h'
       MPIWINTEST( WIN, FLAG, IERROR)
            INTEGER  WIN, IERROR


CC++++ SSyynnttaaxx
       #include 
       bool MPI::Win::Test() const


IINNPPUUTT PPAARRAAMMEETTEERRSS
       win       Window object (handle)



OOUUTTPPUUTT PPAARRAAMMEETTEERRSS
       IERROR    Fortran only: Error status (integer).

       flag      The returning state of the test for epoch closure.



DESCRIPTION
       MPIWintest is a one-sided MPI communication synchronization  call,  a
       nonblocking   version   of  MPIWinwait.  It  returns  ag  =  true  if
       MPIWinwait would return, ag = false otherwise. The effect  of  return
       of  MPIWintest with flag = true is the same as the effect of a return
       of MPIWinwait. If ag = false is returned, then the call has no  visi-
       ble effect.

       Invoke  MPIWintest  only  where MPIWinwait can be invoked. Once the
       call has returned ag = true, it must not be  invoked  anew,  until  the
       window is posted anew.



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. By default, this error handler aborts the MPI job,  except  for
       I/O   function   errors.   The   error  handler  may  be  changed  with
       MPIWinseterrhandler; the predefined error handler  MPIERRORSRETURN
       may  be  used  to cause error values to be returned. Note that MPI does
       not guarantee that an MPI program can continue past an error.


SEE ALSO
       MPIWinpost MPIWinwait




Open MPI 1.2                      March 2007            MPIWintest(3OpenMPI)