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 参数中。

    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