MPI_Group_excl függvény

Egy csoportkonstruktor, amely egy új csoport definiálására szolgál a rangok meglévő csoportból való törlésével.

Szintaxis

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

Paraméterek

• hozzáadása
  A meglévő csoport.

• p
  A rangsorolási paraméter elemeinek száma.

• Soraiban
  A csoport azon folyamattömbjei, amelyek nem jelennek meg az új csoportban. A megadott rangoknak érvényesnek kell lenniük a meglévő csoportban. A tömb minden elemének különállónak kell lennie. Ha a tömb üres, akkor az új csoport megegyezik a meglévő csoportával.

• newgroup [out]
  Mutató egy leíróra, amely a meglévő csoportból származtatott új csoportot jelöli. A meglévő csoport sorrendje megmarad az új csoportban.

Visszatérési érték

Sikeres MPI_SUCCESS ad vissza. Ellenkező esetben a visszatérési érték hibakód.

A Fortranban a visszatérési érték az IERROR paraméterben lesz tárolva.

Fortran

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

Megjegyzések

Ez a függvény egy új folyamatcsoportot hoz létre, amely úgy származik, hogy eltávolítja a megadott folyamatokat egy meglévő csoportból, miközben megőrzi a csoport sorainak sorrendjét.

Követelmények

Termék	HPC Pack 2012 MS-MPI terjeszthető csomag, HPC Pack 2008 R2 MS-MPI terjeszthető csomag, HPC Pack 2008 MS-MPI terjeszthető csomag vagy HPC Pack 2008 Client Utilities
Fejléc	Mpi.h; Mpif.h
Kódtár	Msmpi.lib
DLL	Msmpi.dll

Lásd még

MPI-csoportfüggvények