MPI_Group_range_excl funkce

Vytvoří novou skupinu odebráním procesů z existující skupiny.

Syntaxe

int MPIAPI MPI_Group_range_excl(
        MPI_Group         group,
        int               n,
        _In_count_(n) int ranges[][3],
  _Out_ MPI_Group         *newgroup
);

Parametry

• skupina
  Existující skupina

• n
  Počet rozsahů procesů, které se mají z nové skupiny vyloučit.

• Rozsahy
  Pole specifikací procesů, které se mají vyloučit z existující skupiny. Každý prvek pole určuje rozsah procesu ve formě tří celých čísel pro první pořadí, poslední pořadí a krok.

• nová skupina [out]
  Ukazatel na popisovač, který představuje novou skupinu obsahující procesy, které nebyly vyloučeny. Pořadí skupiny se 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_RANGE_EXCL(GROUP, N, RANGES, NEWGROUP, IERROR)
        INTEGER GROUP, N, RANGES(3,*), NEWGROUP, IERROR

Poznámky

Každé vypočítané pořadí musí být platným pořadím v existující skupině a všechna vypočítaná pořadí musí být odlišná; v opačném případě funkce vrátí chybu.

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_Group_excl

MPI_Comm_group