MPI_Group_incl-Funktion

Erstellt eine neue Gruppe, die eine Teilmenge der Prozesse in einer vorhandenen Gruppe enthält.

Syntax

int MPIAPI MPI_Group_incl(
        MPI_Group         group,
        int               n,
        _In_count_(n) int *ranks,
  _Out_ MPI_Group         *newgroup
);

Parameter

• group
  Die vorhandene Gruppe.

• n
  Die Anzahl der Elemente im Ranks-Parameter und die Größe der neuen Gruppe.

• Reihen
  Die Prozesse, die in die neue Gruppe aufgenommen werden sollen.

• newgroup [out]
  Ein Zeiger auf ein Handle, das die neue Gruppe darstellt, die die eingeschlossenen Prozesse in der Reihenfolge enthält, in der sie im Ranks-Parameter angegeben sind.

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_INCL(GROUP, N, RANKS, NEWGROUP, IERROR)
        INTEGER GROUP, N, RANKS(*), NEWGROUP, IERROR

Hinweise

Diese Funktion kann verwendet werden, um die Elemente einer Gruppe neu anzuordnen.

Dies ist ein lokaler Vorgang. Verschiedene Prozesse können unterschiedliche Gruppen definieren. Ein Prozess kann eine Gruppe definieren, die sich selbst nicht enthält.

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

Anforderungen

Produkt	HHPC 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