MPI_Iallgather 函数

项目
12/27/2023

从组的所有成员收集数据，以非阻止方式将数据发送到组的所有成员。

语法

int MPIAPI MPI_Iallgather(
  _In_opt_  const void         *sendbuf,
  _In_             int         sendcount,
  _In_            MPI_Datatype sendtype,
  _Out_opt_       void         *recvbuf,
  _In_            int          recvcount,
  _In_            MPI_Datatype recvtype,
  _In_            MPI_Comm     comm,
  _Out_           MPI_Request  *request
);

参数

sendbuf [in，可选]
指向要发送到组中的所有进程的数据的指针。缓冲区中元素的数量和数据类型在 sendcount 和 sendtype 参数中指定。缓冲区中的每个元素对应于组中的一个进程。

如果 comm 参数引用内部通信器，可以通过在所有进程中指定 MPI_IN_PLACE 来指定就地选项。 忽略 sendcount 和 sendtype 参数。每个进程在相应的接收缓冲区元素中输入数据。 第 n个进程将数据发送到接收缓冲区的第 n个元素。
sendcount [in]
在 sendbuf 参数中指定的缓冲区中的元素数。如果 sendcount 为零，则消息的数据部分为空。
sendtype [in]
发送缓冲区中元素的 MPI 数据类型。
recvbuf [out，可选]
指向缓冲区的指针，该缓冲区包含从每个进程接收的数据。缓冲区中元素的数量和数据类型在 recvcount 和 recvtype 参数中指定。
recvcount [in]
接收缓冲区中的元素数。如果计数为零，则消息的数据部分为空。
recvtype [in]
接收缓冲区中元素的 MPI 数据类型。
comm [in]
MPI_Comm通信器句柄。
request [out]
表示通信操作 的MPI_Request 句柄。

返回值

返回成功 时MPI_SUCCESS 。否则，返回值为错误代码。

在 Fortran 中，返回值存储在 IERROR 参数中。

Fortran

    MPI_IALLGATHER(SENDBUF, SENDCOUNT, SENDTYPE, RECVBUF, RECVCOUNT, RECVTYPE, COMM, REQUEST, IERROR)
        <type> SENDBUF(*), RECVBUF(*)
        INTEGER SENDCOUNT, SENDTYPE, RECVCOUNT, RECVTYPE, COMM, REQUEST, IERROR