MPI_Comm_size funkce

Načte počet procesů zahrnutých v komunikátoru nebo celkový počet dostupných procesů.

Syntaxe

int MPIAPI MPI_Comm_size(
        MPI_Comm comm,
  _Out_ int      *size
);

Parametry

• Komunikace
  Komunikátor, který se má vyhodnotit. Zadejte konstantu MPI_COMM_WORLD pro načtení celkového počtu dostupných procesů.

• velikost [out]
  Při vrácení určuje počet procesů ve skupině pro komunikátor.

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_COMM_SIZE(COMM,SIZE,IERROR)
        INTEGER COMM, SIZE, IERROR

Poznámky

Tato funkce umožňuje uživateli načíst velikost skupiny jedním voláním funkce. Jinak by bylo nutné vytvořit dočasnou skupinu pomocí funkce MPI_Comm_group , získat velikost skupiny pomocí funkce MPI_Group_size a pak dočasnou skupinu uvolnit pomocí funkce MPI_Group_free .

Tato funkce se často používá spolu s funkcí MPI_Comm_rank k určení rozsahu souběžnosti, která je k dispozici pro konkrétní knihovnu nebo program. Funkce MPI_Comm_rank označuje pořadí procesu, který ho volá, v rozsahu od 0 do size-1, kde se velikost načte pomocí funkce MPI_Comm_size .

Poznámka

Po inicializaci neexistuje žádný standardní způsob, jak změnit počet procesů.

 

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 komunikátoru MPI

MPI_Comm_rank