Partager via


MPI_Group_excl, fonction

Constructeur de groupe utilisé pour définir un nouveau groupe en supprimant les rangs d’un groupe existant.

Syntaxe

int MPIAPI MPI_Group_excl(
        MPI_Group         group,
        int               n,
        _In_count_(n) int *ranks,
  _Out_ MPI_Group         *newgroup
);

Paramètres

  • groupe
    Groupe existant.

  • n
    Nombre d’éléments dans le paramètre ranks .

  • Rangs
    Tableaux des processus dans le groupe qui ne doivent pas apparaître dans newgroup. Les rangs spécifiés doivent être valides dans le groupe existant. Chaque élément du tableau doit être distinct. Si le tableau est vide, le nouveau groupe sera identique au groupe existant.

  • newgroup [out]
    Pointeur vers un handle qui représente le nouveau groupe dérivé du groupe existant. L’ordre du groupe existant est conservé dans le nouveau groupe.

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_GROUP_EXCL(GROUP, N, RANKS, NEWGROUP, IERROR)
        INTEGER GROUP, N, RANKS(*), NEWGROUP, IERROR

Remarques

Cette fonction crée un groupe de processus dérivé en supprimant les processus spécifiés d’un groupe existant tout en conservant l’ordre des rangs dans le groupe.

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 de groupe MPI