MPI_Comm_size függvény

Lekéri a kommunikátorban részt vevő folyamatok számát vagy a rendelkezésre álló folyamatok teljes számát.

Szintaxis

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

Paraméterek

• Comm
  A kiértékelendő kommunikátor. Adja meg a MPI_COMM_WORLD konstanst az elérhető folyamatok teljes számának lekéréséhez.

• méret [kifelé]
  A visszatérési érték a kommunikátor csoportjában lévő folyamatok számát jelzi.

Visszatérési érték

Sikeres MPI_SUCCESS ad vissza. Ellenkező esetben a visszatérési érték hibakód.

A Fortranban a visszatérési érték az IERROR paraméterben van tárolva.

Fortran

    MPI_COMM_SIZE(COMM,SIZE,IERROR)
        INTEGER COMM, SIZE, IERROR

Megjegyzések

Ez a függvény lehetővé teszi, hogy a felhasználó egyetlen függvényhívással kérje le a csoport méretét. Ellenkező esetben létre kell hozni egy ideiglenes csoportot az MPI_Comm_group függvénnyel, le kell szerezni a csoport méretét a MPI_Group_size függvénnyel, majd az ideiglenes csoportot felszabadítani a MPI_Group_free függvénnyel.

Ezt a függvényt gyakran használják a MPI_Comm_rank függvénnyel egy adott kódtár vagy program egyidejűségének meghatározására. A MPI_Comm_rank függvény annak a folyamatnak a rangját jelzi, amely 0 és 1 közötti tartományban hívja meg, ahol a méret a MPI_Comm_size függvénnyel kérhető le.

Megjegyzés

Az inicializálás után nincs szabványos módszer a folyamatok számának módosítására.

 

Követelmények

Termék	HPC Pack 2012 MS-MPI terjeszthető csomag, HPC Pack 2008 R2 MS-MPI terjeszthető csomag, HPC Pack 2008 MS-MPI újraterjeszthető csomag vagy HPC Pack 2008 ügyfél-segédprogramok
Fejléc	Mpi.h; Mpif.h
Kódtár	Msmpi.lib
DLL	Msmpi.dll

Lásd még

MPI Communicator-függvények

MPI_Comm_rank