MPI_Iscatter函式

發行項
01/16/2024

以非封鎖方式，將群組所有成員之間的數據散佈在一個成員之間。此函式會執行 MPI_Igather函式所執行的作業反轉。

語法

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

參數

sendbuf [in， optional]
緩衝區的指標，其中包含要傳送至根進程的數據。

所有非根進程都會忽略此參數。

如果 comm 參數參考內部通訊器，您可以在根程式中指定 MPI_IN_PLACE 來指定就地選項。 會忽略 recvcount 和recvtype 參數。散佈向量仍被視為包含 n 個區段，其中 n 是群組大小;對應至根進程的區段不會移動。
sendcount [in]
傳送緩衝區中的項目數目。如果 sendcount 是零，則訊息的數據部分是空的。

所有非根進程都會忽略此參數。
sendtype [in]
緩衝區中每個項目的數據類型。

所有非根進程都會忽略此參數。
recvbuf [out，選擇性]
緩衝區的句柄，其中包含每個進程上收到的數據。緩衝區中元素的數目和數據類型是在 recvcount 和 recvtype 參數中指定。
recvcount [in]
接收緩衝區中的項目數目。如果計數為零，則訊息的數據部分是空的。
recvtype [in]
接收緩衝區中專案的 MPI 數據類型。
root [in]
指定通訊器內接收進程的排名。
comm [in]
MPI_Comm通訊器句柄。
要求 [out]
表示通訊作業 的MPI_Request 句柄。

傳回值

傳回成功 時MPI_SUCCESS 。否則，傳回值是錯誤碼。

在 Fortran 中，傳回值會儲存在 IERROR 參數中。

Fortran

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