共用方式為

MPI_Group_incl函式

  • 發行項

建立新的群組，其中包含現有群組中的進程子集。

語法

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

參數

  • 群組
    現有的群組。

  • n
    ranks參數中的元素數目，以及新群組的大小。

  • 行列
    要包含在新群組中的進程。

  • newgroup [out]
    表示新群組之控制碼的指標，其包含包含在 ranks 參數中指定的進程順序。

傳回值

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

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

Fortran

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

備註

此函式可用來重新排序群組的專案。

這是本機作業。 不同的進程可以定義不同的群組。 進程可以定義不包含本身的群組。

MPI 實作不提供從頭開始建置群組的機制，但只提供現有群組的機制。 可以使用 MPI_Comm_group 函式來擷取所有其他群組的基底群組。 它是與初始通訊器 MPI_COMM_WORLD相關聯的群組。

規格需求

產品

HHPC 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 群組函式

MPI_Comm_group