MPI_Group_incl函数
创建一个新组，其中包含现有组中进程的子集。
语法
int MPIAPI MPI_Group_incl(
MPI_Group group,
int n,
_In_count_(n) int *ranks,
_Out_ MPI_Group *newgroup
);
参数
group
现有组。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 |