MPI_Group_difference函式
從兩個現有群組之間的差異建立新的群組。
語法
int MPIAPI MPI_Group_difference(
MPI_Group group1,
MPI_Group group2,
_Out_ MPI_Group *newgroup
);
參數
group1
第一個群組。group2
第二個群組。newgroup [out]
句柄的指標，表示新群組，其中包含第一個群組中不存在的第一個群組中的所有元素。 如果新群組是空的，此函式會傳回 MPI_GROUP_EMPTY 。
傳回值
傳回成功 時MPI_SUCCESS 。 否則，傳回值是錯誤碼。
在 Fortran 中，傳回值會儲存在 IERROR 參數中。
Fortran
MPI_GROUP_DIFFERENCE(GROUP1, GROUP2, NEWGROUP, IERROR)
INTEGER GROUP1, GROUP2, NEWGROUP, IERROR
備註
這是本機作業。 不同的進程可以定義不同的群組。 進程可以定義不包含本身的群組。
MPI 實作不提供從頭開始建置群組的機制，但只提供現有群組的機制。 可以使用 MPI_Comm_group 函式來擷取所有其他群組的基底群組。 它是與初始通訊器 MPI_COMM_WORLD相關聯的群組。
規格需求
產品 |
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 |