共用方式為

MPI_Group_excl 函式

  • 發行項

群組建構函式，用來從現有群組刪除排名來定義新的群組。

語法

int MPIAPI MPI_Group_excl(
        MPI_Group         group,
        int               n,
        _In_count_(n) int *ranks,
  _Out_ MPI_Group         *newgroup
);

參數

  • 群組
    現有的群組。

  • n
    ranks 參數中的元素數目。

  • 行列
    群組中未出現在新群組中的進程陣列。 指定的排名在現有群組中必須有效。 陣列中的每個元素都必須是相異的。 如果陣列是空的，則新的群組會與現有的群組相同。

  • newgroup [out]
    句柄的指標，表示衍生自現有群組的新群組。 現有群組的順序會保留在新群組中。

傳回值

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

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

Fortran

    MPI_GROUP_EXCL(GROUP, N, RANKS, NEWGROUP, IERROR)
        INTEGER GROUP, N, RANKS(*), NEWGROUP, IERROR

備註

此函式會建立新的進程群組，其衍生方式是移除現有群組中的指定進程，同時保留群組中排名的順序。

規格需求

產品

HPC Pack 2012 MS-MPI 可轉散發套件、HPC Pack 2008 R2 MS-MPI 可轉散發套件、HPC Pack 2008 MS-MPI 可轉散發套件或 HPC Pack 2008 用戶端公用程式

標頭

 Mpi.h;Mpif.h

媒體櫃

 Msmpi.lib

DLL

 Msmpi.dll

另請參閱

MPI 群組函式