MPI_Group_difference funkce

Vytvoří novou skupinu z rozdílu mezi dvěma existujícími skupinami.

Syntaxe

int MPIAPI MPI_Group_difference(
        MPI_Group group1,
        MPI_Group group2,
  _Out_ MPI_Group *newgroup
);

Parametry

• skupina1
  První skupina.

• skupina2
  Druhá skupina.

• nová skupina [out]
  Ukazatel na popisovač, který představuje novou skupinu obsahující všechny prvky v první skupině, které nejsou přítomny ve druhé skupině. Funkce vrátí MPI_GROUP_EMPTY , pokud je nová skupina prázdná.

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_DIFFERENCE(GROUP1, GROUP2, NEWGROUP, IERROR)
        INTEGER GROUP1, GROUP2, NEWGROUP, IERROR 

Poznámky

Jedná se o místní operaci. Různé procesy mohou definovat odlišné skupiny. Proces může definovat skupinu, která nezahrnuje sebe sama.

Implementace MPI neposkytuje mechanismus pro vytvoření skupiny od začátku, ale pouze z existujících skupin. Základní skupinu, ve které jsou definovány všechny ostatní skupiny, lze načíst pomocí funkce MPI_Comm_group . Jedná se o skupinu, která je přidružena k počátečnímu komunikátoru MPI_COMM_WORLD.

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

MPI_Comm_group