Dela via


funktionen MPI_Comm_rank

Hämtar rangordningen för anropsprocessen i gruppen för den angivna kommunikatören.

Syntax

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

Parametrar

  • Comm
    Kommunikatören.

  • rangordna [ut]
    När du returnerar pekaren till identifieraren för anropsprocessen i gruppen för kommunikatören.

Returvärde

Returnerar MPI_SUCCESS vid lyckat resultat. Annars är returvärdet en felkod.

I Fortran lagras returvärdet i parametern IERROR .

Fortran

    MPI_COMM_RANK(COMM,RANK,IERROR)
        INTEGER COMM, RANK, IERROR

Kommentarer

Med den här funktionen kan användaren hämta processrankningen med ett enda funktionsanrop. Annars skulle det vara nödvändigt att skapa en tillfällig grupp med hjälp av funktionen MPI_Comm_group , hämta rangordningen i gruppen med hjälp av funktionen MPI_Group_rank och sedan frigöra den tillfälliga gruppen med hjälp av funktionen MPI_Group_free .

Krav

Produkt

HPC Pack 2012 MS-MPI Redistributable Package, HPC Pack 2008 R2 MS-MPI Redistributable Package, HPC Pack 2008 MS-MPI Redistributable Package eller HPC Pack 2008 Client Utilities

Huvud

Mpi.h; Mpif.h

Bibliotek

Msmpi.lib

DLL

Msmpi.dll

Se även

MPI Communicator Functions

MPI_Comm_size