MPI_Sendrecv_replace(3)

NAME
     MPI_Sendrecv_replace - Sends and receives using a single buffer

SYNOPSIS
     C:

          #include <mpi.h>

          int MPI_Sendrecv_replace( buf, count, datatype, dest,
          sendtag, source, recvtag, comm, status )
          void         *buf;
          int           count, dest, sendtag, source, recvtag;
          MPI_Datatype  datatype;
          MPI_Comm      comm;
          MPI_Status   *status;


     C++:

          #include <mpi.h>

          void Comm::Sendrecv_replace(
          void*             buf,
          int               count,
          const Datatype&   datatype,
          int               dest,
          int               sendtag,
          int               source,
          int               recvtag) const


     Fortran:

          INCLUDE "mpif.h" (or USE MPI)

          <type> BUF(*)
          INTEGER count, datatype, dest, sendtag, source, recvtag,
          comm, status(MPI_STATUS_SIZE), ierror

          CALL MPI_SENDRECV_REPLACE(buf, count, datatype, dest, sendtag,
          source, recvtag, comm, status(MPI_STATUS_SIZE), ierror)


STANDARDS
     This release implements the MPI 1.2 standard, as documented by the MPI
     Forum in the spring 1997 release of MPI:  A Message Passing Interface
     Standard.

DESCRIPTION
     The MPI_Sendrecv_replace routine uses a single buffer to perform send and
     receive operations.  This routine accepts the following parameters:
     count     Specifies the number of elements in the send and receive buffer
               (integer)

     datatype  Specifies the type of elements in the send and receive buffer
               (handle)

     dest      Specifies the rank of the destination (integer)

     sendtag   Specifies the send message tag (integer)

     source    Specifies the rank of the source (integer)

     recvtag   Specifies the receive message tag (integer)

     comm      Specifies the communicator (handle)

     buf       Returns the initial address of the send and receive buffer
               (choice)

     status    Returns the status object (status)

     ierror    Specifies the return code value for successful completion,
               which is in MPI_SUCCESS.  MPI_SUCCESS is defined in the mpif.h
               file.