MPI_Group_union, fonction
Crée un groupe à partir de l’union de deux groupes existants.
Syntaxe
int MPIAPI MPI_Group_union(
MPI_Group group1,
MPI_Group group2,
_Out_ MPI_Group *newgroup
);
Paramètres
group1
Premier groupe.group2
Deuxième groupe.newgroup [out]
Au retour, contient un pointeur vers un nouveau groupe qui représente tous les éléments de l’un ou l’autre 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_UNION(GROUP1, GROUP2, NEWGROUP, IERROR)
INTEGER GROUP1, GROUP2, NEWGROUP, IERROR
Remarques
Il s’agit d’une opération locale. Différents processus peuvent définir des groupes distincts. Un processus peut définir un groupe qui ne s’inclut pas lui-même.
L’implémentation MPI ne fournit pas de mécanisme pour créer un groupe à partir de zéro, mais uniquement à partir de groupes existants. Le groupe de base, sur lequel tous les autres groupes sont définis, peut être récupéré à l’aide de la fonction MPI_Comm_group . Il s’agit du groupe associé au communicateur initial MPI_COMM_WORLD.
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 |