MPI_Group_excl 函数

一个组构造函数，用于通过从现有组中删除排名来定义新组。

语法

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

参数

• group
  现有组。

• n
  ranks 参数中的元素数。

• 行列
  组中不会显示在新组中的进程数组。 指定的排名在现有组中必须有效。 数组中的每个元素都必须是不同的。 如果数组为空，则新组将与现有组相同。

• newgroup [out]
  指向句柄的指针，该句柄表示从现有组派生的新组。 新组中保留现有组的顺序。

返回值

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

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

Fortran

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

注解

此函数创建一组新的进程，该组通过从现有组中删除指定进程来派生，同时保留组中排名的顺序。

要求

另请参阅

MPI 组函数