MPI_Comm_rank-Funktion

Ruft den Rang des aufrufenden Prozesses in der Gruppe des angegebenen Communicators ab.

Syntax

int MPIAPI MPI_Comm_rank(
        MPI_Comm comm,
  _Out_ int      *rank
);

Parameter

• comm
  Der Kommunikator.

• rangieren [out]
  Bei der Rückgabe ein Zeiger auf den Bezeichner des aufrufenden Prozesses innerhalb der Gruppe des Communicators.

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_RANK(COMM,RANK,IERROR)
        INTEGER COMM, RANK, IERROR

Hinweise

Mit dieser Funktion kann der Benutzer den Prozessrang mit einem einzelnen Funktionsaufruf abrufen. Andernfalls wäre es erforderlich, eine temporäre Gruppe mithilfe der funktion MPI_Comm_group zu erstellen, den Rang in der Gruppe mithilfe der funktion MPI_Group_rank abzurufen und dann die temporäre Gruppe mit der funktion MPI_Group_free frei zu geben.

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

MPI_Comm_size