MPI_Gather - Gathers values from a group of processes


SYNOPSIS

       C:

            #include <mpi.h>

            int MPI_Gather ( sendbuf, sendcnt, sendtype, recvbuf,
            recvcount, recvtype, root, comm )
            void             *sendbuf;
            int               sendcnt;
            MPI_Datatype      sendtype;
            void             *recvbuf;
            int               recvcount;
            MPI_Datatype      recvtype;
            int               root;
            MPI_Comm          comm;

       C++:

            #include <mpi.h>

            void Intracomm::Gather(
            const void*       sendbuf,
            int               sendcount,
            const Datatype&   sendtype,
            void*             recvbuf,
            int               recvcount,
            const Datatype&   recvtype,
            int               root) const

       Fortran:

            INCLUDE "mpif.h" (or USE MPI)

            <type> SENDBUF(*), RECVBUF(*)
            INTEGER sendcount, sendtype, recvcount, recvtype,
            root, comm, ierror

            CALL MPI_GATHER(sendbuf, sendcount, sendtype,
            recvbuf, recvcount, recvtype, root, comm,
            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_Gather routine gathers values from a group of


       sendbuf        Specifies the starting address of the send
                      buffer (choice)

       sendcnt        Specifies the number of elements in the
                      send buffer (integer)

       sendtype       Specifies the data type of the send buffer
                      elements (handle)

       recvcount      Specifies the number of elements for any
                      single receive operation (integer;
                      significant only at root)

       recvtype       Specifies the data type of the receive
                      buffer elements (handle; significant only
                      at root)

       root           Specifies the rank of the receiving process
                      (integer)

       comm           Specifies the communicator (handle)

       recvbuf        Returns the address of the receive buffer
                      (choice; significant only at root)

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


Man(1) output converted with man2html