MPI_Group_excl funkce

Konstruktor skupiny, který se používá k definování nové skupiny odstraněním pořadí z existující skupiny.

Syntaxe

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

Parametry

• skupina
  Existující skupina

• n
  Počet prvků v parametru pořadí .

• Řad
  Pole procesů ve skupině , které se nemají objevit v nové skupině. Zadané pořadí musí být platné v existující skupině. Každý prvek v poli musí být odlišný. Pokud je pole prázdné, bude nová skupina identická s existující skupinou.

• nová skupina [out]
  Ukazatel na popisovač, který představuje novou skupinu odvozenou od existující skupiny. Pořadí existující skupiny se v nové skupině zachová.

Vrácená hodnota

Vrátí MPI_SUCCESS při úspěchu. V opačném případě je návratovou hodnotou kód chyby.

Ve Fortranu je vrácená hodnota uložena v parametru IERROR .

Fortran

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

Poznámky

Tato funkce vytvoří novou skupinu procesů, která se odvozuje odebráním zadaných procesů z existující skupiny při zachování pořadí ve skupině.

Požadavky

Produkt	HPC Pack 2012 MS-MPI Redistributable Package, HPC Pack 2008 R2 MS-MPI Redistributable Package, HPC Pack 2008 MS-MPI Redistributable Package nebo HPC Pack 2008 Client Utilities
Hlavička	Mpi.h; Soubor Mpif.h
Knihovna	Msmpi.lib
DLL	Msmpi.dll

Viz také

Funkce skupiny MPI