MPI_Group_union 函数

从两个现有组的联合创建新组。

语法

int MPIAPI MPI_Group_union(
        MPI_Group group1,
        MPI_Group group2,
  _Out_ MPI_Group *newgroup
);

参数

  • group1
    第一组。

  • group2
    第二组。

  • newgroup [out]
    返回时,包含指向表示任一组中所有元素的新组的指针。

返回值

返回成功 时MPI_SUCCESS 。 否则,返回值为错误代码。

在 Fortran 中,返回值存储在 IERROR 参数中。

Fortran

    MPI_GROUP_UNION(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

另请参阅

MPI 组函数

MPI_Comm_group