MPI_Comm_rank fonction

Récupère le rang du processus appelant dans le groupe du communicateur spécifié.

Syntaxe

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

Paramètres

• comm
  Le communicateur.

• rank [out]
  Au retour, pointeur vers l’identificateur du processus appelant dans le groupe du communicateur.

Valeur retournée

Retourne MPI_SUCCESS en cas de réussite. Sinon, la valeur de retour est un code d’erreur.

Dans Fortran, la valeur de retour est stockée dans le paramètre IERROR .

Fortran

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

Remarques

Cette fonction permet à l’utilisateur de récupérer le classement du processus avec un seul appel de fonction. Sinon, il serait nécessaire de créer un groupe temporaire à l’aide de la fonction MPI_Comm_group , d’obtenir le rang dans le groupe à l’aide de la fonction MPI_Group_rank , puis de libérer le groupe temporaire à l’aide de la fonction MPI_Group_free .

Configuration requise

Produit	Package redistribuable MS-MPI HPC Pack 2012, package redistribuable HPC Pack 2008 R2 MS-MPI, package redistribuable MS-MPI HPC Pack 2008 ou utilitaires clients HPC Pack 2008
En-tête	Mpi.h ; Mpif.h
Bibliothèque	Msmpi.lib
DLL	Msmpi.dll

Voir aussi

Fonctions communicator MPI

MPI_Comm_size