funktionen MPI_Comm_size
Hämtar antalet processer som ingår i en kommunikatör eller det totala antalet tillgängliga processer.
Syntax
int MPIAPI MPI_Comm_size(
MPI_Comm comm,
_Out_ int *size
);
Parametrar
Comm
Kommunikatören som ska utvärderas. Ange den MPI_COMM_WORLD konstanten för att hämta det totala antalet tillgängliga processer.storlek [ut]
Vid retur anger antalet processer i gruppen för kommunikatören.
Returvärde
Returnerar MPI_SUCCESS vid lyckat resultat. Annars är returvärdet en felkod.
I Fortran lagras returvärdet i parametern IERROR .
Fortran
MPI_COMM_SIZE(COMM,SIZE,IERROR)
INTEGER COMM, SIZE, IERROR
Kommentarer
Med den här funktionen kan användaren hämta gruppstorleken med ett enda funktionsanrop. Annars skulle det vara nödvändigt att skapa en tillfällig grupp med hjälp av funktionen MPI_Comm_group , hämta storleken på gruppen med hjälp av funktionen MPI_Group_size och sedan frigöra den tillfälliga gruppen med hjälp av funktionen MPI_Group_free .
Den här funktionen används ofta med funktionen MPI_Comm_rank för att fastställa hur mycket samtidighet som är tillgänglig för ett visst bibliotek eller program. Funktionen MPI_Comm_rank anger rangordningen för den process som anropar den i intervallet från 0 till storlek-1, där storleken hämtas med hjälp av funktionen MPI_Comm_size .
Anteckning
Det finns inget standardsätt att ändra antalet processer när initieringen har ägt rum.
Krav
Produkt |
HPC Pack 2012 MS-MPI Redistributable Package, HPC Pack 2008 R2 MS-MPI Redistributable Package, HPC Pack 2008 MS-MPI Redistributable Package eller HPC Pack 2008 Client Utilities |
Huvud |
Mpi.h; Mpif.h |
Bibliotek |
Msmpi.lib |
DLL |
Msmpi.dll |