Freigeben über


MPI_Comm_compare-Funktion

Vergleicht zwei Communicatorhandles.

Syntax

int MPIAPI MPI_Comm_compare(
        MPI_Comm comm1,
        MPI_Comm comm2,
  _Out_ int      *result
);

Parameter

comm1

Ein Handle für den ersten zu vergleichenden Kommunikator.

comm2

Ein Handle für den zweiten zu vergleichenden Kommunikator.

Ergebnis [out]

Bei der Rückgabe wird ein Zeiger auf die Ergebnisse des Vergleichs angezeigt.

Die möglichen Werte sind.

MPI_IDENT

Gibt an, dass die beiden Handles für dasselbe Objekt gelten. Die behandelt identische Gruppen und Kontexte.

MPI_CONGRUENT

Gibt an, dass die zugrunde liegenden Gruppen identische Elemente in derselben Rangfolge aufweisen. Diese Kommunikatoren unterscheiden sich nur nach Kontext.

MPI_SIMILAR

Gibt an, dass die zugrunde liegenden Gruppen identische Mitglieder haben, sich aber in unterschiedlichen Rangreihen befinden.

MPI_UNEQUAL

Gibt an, dass die Handles für verschiedene Objekte gelten.

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_COMM_COMPARE(COMM1,COMM2,RESULT,IERROR)
        INTEGER COMM1, COMM1, RESULT, IERROR

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 Communicator-Funktionen