MPI_Group_translate_ranks-Funktion

Bestimmt die relative Nummerierung der gleichen Prozesse in zwei verschiedenen Gruppen.

Syntax

int MPIAPI MPI_Group_translate_ranks(
        MPI_Group         group1,
        int               n,
        _In_count_(n) int *ranks1,
        MPI_Group         group2,
  _Out_ int               *ranks2
);

Parameter

• group1
  Die erste Gruppe.

• n
  Die Anzahl oder rangiert in den Parameterarrays "ranks1 " und "ranks2 ".

• Ränge 1
  Null oder mehr gültige Ränge in der ersten Gruppe.

  Hinweis

  Die MPI_PROC_NULL Konstante ist für diesen Parameter gültig. Der entsprechende Rang, der im Ranks2-Parameter zurückgegeben wird, ist ebenfalls MPI_PROC_NULL.

   

• group2
  Die zweite Gruppe.

• ranks2 [out]
  Zeigt bei der Rückgabe auf die entsprechenden Ränge in der zweiten Gruppe. Der Wert MPI_UNDEFINED gibt an, dass sich ein Prozess in der ersten Gruppe befindet, aber nicht in der zweiten Gruppe.

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_TRANSLATE_RANKS( GROUP1, N, RANKS1, GROUP2, RANKS2, IERROR)
        INTEGER GROUP1, N, RANKS1(*), GROUP2, RANKS2(*), 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-Gruppenfunktionen

MPI_Group_incl