[This is preliminary documentation and is subject to change.]
Gather the values provided by each process into an array containing the contributions of all
of the processes. This routine differs from MPI_Allgather(IntPtr, Int32, Int32, IntPtr, Int32, Int32, Int32) in that the results
are gathered to only the "root" process, which is identified by its rank
in the communicator.
See Gather<(Of <(T>)>)(T, Int32)
Namespace:
MPIAssembly: MPI (in MPI.dll)
Version: 0.8.0.0 (0.8.0.0)
Syntax
| C# |
|---|
public static int MPI_Gatherv( IntPtr sendbuf, int sendcount, int sendtype, IntPtr recvbuf, int[] recvcounts, int[] displs, int recvtype, int root, int comm ) |
| Visual Basic (Declaration) |
|---|
Public Shared Function MPI_Gatherv ( _ sendbuf As IntPtr, _ sendcount As Integer, _ sendtype As Integer, _ recvbuf As IntPtr, _ recvcounts As Integer(), _ displs As Integer(), _ recvtype As Integer, _ root As Integer, _ comm As Integer _ ) As Integer |
| Visual C++ |
|---|
public: static int MPI_Gatherv( IntPtr sendbuf, int sendcount, int sendtype, IntPtr recvbuf, array<int>^ recvcounts, array<int>^ displs, int recvtype, int root, int comm ) |
Parameters
- sendbuf
- Type: System..::.IntPtr
Buffer containing the values that will be sent from this process.
- sendcount
- Type: System..::.Int32
The number of elements to send.
- sendtype
- Type: System..::.Int32
The datatype describing the send buffer.
- recvbuf
- Type: System..::.IntPtr
Buffer that will contain all of the values contributed by every process. This argument is only significant at the root.
- recvcounts
- Type: array<
System..::.Int32
>[]()[]
An array whose ith element is the number of elements to receive from process i. This argument is only significant at the root.
- displs
- Type: array<
System..::.Int32
>[]()[]
An array whose ith element contains the displacement (into recvbuf) at which the data from process i will be placed. This argument is only significant at the root.
- recvtype
- Type: System..::.Int32
The type of data that will be stored in the receive buffer. This argument is only significant at the root.
- root
- Type: System..::.Int32
The rank of the "root" process.
- comm
- Type: System..::.Int32
The communicator over which data will be gathered.