MPI_Group_union-Funktion

Erstellt eine neue Gruppe aus der Union zweier vorhandener Gruppen.

Syntax

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

Parameter

• group1
  Die erste Gruppe.

• group2
  Die zweite Gruppe.

• newgroup [out]
  Enthält bei der Rückgabe einen Zeiger auf eine neue Gruppe, die alle Elemente in beiden Gruppen darstellt.

Rückgabewert

Gibt MPI_SUCCESS nach Erfolg zurück. Andernfalls ist der Rückgabewert ein Fehlercode.

In Fortran wird der Rückgabewert im IERROR-Parameter gespeichert.

Fortran

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

Hinweise

Dies ist ein lokaler Vorgang. Unterschiedliche Prozesse können unterschiedliche Gruppen definieren. Ein Prozess kann eine Gruppe definieren, die sich selbst nicht einschließt.

Die MPI-Implementierung bietet keinen Mechanismus, um eine Gruppe von Grund auf neu zu erstellen, sondern nur aus vorhandenen Gruppen. Die Basisgruppe, in der alle anderen Gruppen definiert sind, kann mithilfe der funktion MPI_Comm_group abgerufen werden. Dies ist die Gruppe, die dem anfänglichen Kommunikator MPI_COMM_WORLD zugeordnet ist.

Anforderungen

Produkt	HPC Pack 2012 MS-MPI Redistributable Package, HPC Pack 2008 R2 MS-MPI Redistributable Package, HPC Pack 2008 MS-MPI Redistributable Package oder HPC Pack 2008 Client Utilities
Header	Mpi.h; Mpif.h
Bibliothek	Msmpi.lib
DLL	Msmpi.dll

Weitere Informationen

MPI-Gruppenfunktionen

MPI_Comm_group