funzione MPI_Group_union
Crea un nuovo gruppo dall'unione di due gruppi esistenti.
Sintassi
int MPIAPI MPI_Group_union(
MPI_Group group1,
MPI_Group group2,
_Out_ MPI_Group *newgroup
);
Parametri
group1
Primo gruppo.group2
Secondo gruppo.newgroup [out]
In caso di restituzione, contiene un puntatore a un nuovo gruppo che rappresenta tutti gli elementi di entrambi i gruppi.
Valore restituito
Restituisce MPI_SUCCESS in caso di esito positivo. In caso contrario, il valore restituito è un codice di errore.
In Fortran il valore restituito viene archiviato nel parametro IERROR .
Fortran
MPI_GROUP_UNION(GROUP1, GROUP2, NEWGROUP, IERROR)
INTEGER GROUP1, GROUP2, NEWGROUP, IERROR
Commenti
Si tratta di un'operazione locale. I diversi processi possono definire gruppi distinti. Un processo può definire un gruppo che non include se stesso.
L'implementazione MPI non fornisce un meccanismo per creare un gruppo da zero, ma solo da gruppi esistenti. Il gruppo di base, su cui sono definiti tutti gli altri gruppi, può essere recuperato usando la funzione MPI_Comm_group . È il gruppo associato al comunicatore iniziale MPI_COMM_WORLD.
Requisiti
Prodotto |
Pacchetto ridistribuibile DI HPC Pack 2012 MS-MPI, HPC Pack 2008 R2 MS-MPI Redistributable Package, HPC Pack 2008 MS-MPI Redistributable Package o utilità client HPC Pack 2008 |
Intestazione |
Mpi.h; Mpif.h |
Libreria |
Msmpi.lib |
DLL |
Msmpi.dll |