Partilhar via


função MPI_Comm_rank

Obtém a classificação do processo de chamada no grupo do comunicador especificado.

Sintaxe

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

Parâmetros

  • vírgula
    O comunicador.

  • rank [out]
    Na devolução, um ponteiro para o identificador do processo de chamada no grupo do comunicador.

Valor devolvido

Devolve MPI_SUCCESS com êxito. Caso contrário, o valor devolvido é um código de erro.

Em Fortran, o valor devolvido é armazenado no parâmetro IERROR .

Fortran

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

Observações

Esta função permite ao utilizador obter a classificação do processo com uma única chamada de função. Caso contrário, seria necessário criar um grupo temporário com a função MPI_Comm_group , obter a classificação no grupo com a função MPI_Group_rank e, em seguida, libertar o grupo temporário com a função MPI_Group_free .

Requisitos

Produto

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

Cabeçalho

Mpi.h; Mpif.h

Biblioteca

Msmpi.lib

DLL

Msmpi.dll

Ver também

Funções do Comunicador MPI

MPI_Comm_size