MPI_Comm_size functie
Haalt het aantal processen op dat betrokken is bij een communicator of het totale aantal beschikbare processen.
Syntaxis
int MPIAPI MPI_Comm_size(
MPI_Comm comm,
_Out_ int *size
);
Parameters
Comm
De communicator die moet worden geëvalueerd. Geef de MPI_COMM_WORLD constante op om het totale aantal beschikbare processen op te halen.grootte [uit]
Bij terugkeer wordt het aantal processen in de groep voor de communicator aangegeven.
Retourwaarde
Retourneert MPI_SUCCESS bij succes. Anders is de retourwaarde een foutcode.
In Fortran wordt de retourwaarde opgeslagen in de parameter IERROR .
Fortran
MPI_COMM_SIZE(COMM,SIZE,IERROR)
INTEGER COMM, SIZE, IERROR
Opmerkingen
Met deze functie kan de gebruiker de groepsgrootte ophalen met één functieaanroep. Anders zou het nodig zijn om een tijdelijke groep te maken met behulp van de functie MPI_Comm_group , de grootte van de groep op te halen met behulp van de functie MPI_Group_size en de tijdelijke groep vervolgens vrij te maken met behulp van de functie MPI_Group_free .
Deze functie wordt vaak gebruikt met de functie MPI_Comm_rank om de hoeveelheid gelijktijdigheid te bepalen die beschikbaar is voor een specifieke bibliotheek of programma. De functie MPI_Comm_rank geeft de rangorde aan van het proces dat het aanroept in het bereik van 0 tot grootte-1, waarbij de grootte wordt opgehaald met behulp van de functie MPI_Comm_size .
Notitie
Er is geen standaardmethode om het aantal processen te wijzigen nadat de initialisatie heeft plaatsgevonden.
Vereisten
Product |
HPC Pack 2012 MS-MPI Redistributable Package, HPC Pack 2008 R2 MS-MPI Redistributable Package, HPC Pack 2008 MS-MPI Redistributable Package of HPC Pack 2008 Client Utilities |
Header |
Mpi.h; Mpif.h |
Bibliotheek |
Msmpi.lib |
DLL |
Msmpi.dll |