MPI_Group_range_excl függvény

Új csoportot hoz létre, ha eltávolítja a folyamatokat egy meglévő csoportból.

Szintaxis

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

Paraméterek

• hozzáadása
  A meglévő csoport.

• p
  Az új csoportból kizárandó folyamattartományok száma.

• Tartományok
  A meglévő csoportból kizárandó folyamatok specifikációinak tömbje. A tömb minden eleme egy folyamattartományt határoz meg három egész szám formájában az első rangsorhoz, az utolsó ranghoz és a lépéshez.

• newgroup [out]
  Mutató egy leíróra, amely azokat a folyamatokat tartalmazó új csoportot jelöli, amelyek nem lettek kizárva. A csoport sorrendje megmarad.

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_GROUP_RANGE_EXCL(GROUP, N, RANGES, NEWGROUP, IERROR)
        INTEGER GROUP, N, RANGES(3,*), NEWGROUP, IERROR

Megjegyzések

Minden kiszámított rangsornak érvényes rangnak kell lennie a meglévő csoportban, és minden kiszámított rangsornak eltérőnek kell lennie; ellenkező esetben a függvény hibát ad vissza.

Ez egy helyi művelet. A különböző folyamatok különböző csoportokat definiálhatnak. A folyamatok definiálhatnak olyan csoportot, amely nem tartalmazza magát.

Az MPI-implementáció nem biztosít olyan mechanizmust, amely teljesen új csoportot hoz létre, csak meglévő csoportokból. Az alapcsoport, amelyre az összes többi csoport definiálva van, a MPI_Comm_group függvénnyel kérhető le. Ez az a csoport, amely a kezdeti communicator MPI_COMM_WORLD van társítva.

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-csoportfüggvények

MPI_Group_excl

MPI_Comm_group