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 グループ関数