MPI_Group_union függvény

Létrehoz egy új csoportot két meglévő csoportból.

Szintaxis

int MPIAPI MPI_Group_union(
        MPI_Group group1,
        MPI_Group group2,
  _Out_ MPI_Group *newgroup
);

Paraméterek

• group1
  Az első csoport.

• group2
  A második csoport.

• newgroup [out]
  Visszatérés esetén egy új csoportra mutató mutatót tartalmaz, amely a csoport összes elemét jelöli.

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 lesz tárolva.

Fortran

    MPI_GROUP_UNION(GROUP1, GROUP2, NEWGROUP, IERROR)
        INTEGER GROUP1, GROUP2, NEWGROUP, IERROR 

Megjegyzések

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 mechanizmust a csoportok nulláról történő létrehozásához, csak a meglévő csoportokból. Az alapcsoport, amelyre az összes többi csoport definiálva van, lekérhető a MPI_Comm_group függvénnyel. Ez az a csoport, amely a kezdeti kommunikátor 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 terjeszthető csomag vagy HPC Pack 2008 Client Utilities
Fejléc	Mpi.h; Mpif.h
Kódtár	Msmpi.lib
DLL	Msmpi.dll

Lásd még

MPI-csoportfüggvények

MPI_Comm_group