funzione MPI_Group_difference
Crea un nuovo gruppo dalla differenza tra due gruppi esistenti.
Sintassi
int MPIAPI MPI_Group_difference(
MPI_Group group1,
MPI_Group group2,
_Out_ MPI_Group *newgroup
);
Parametri
group1
Primo gruppo.group2
Secondo gruppo.newgroup [out]
Puntatore a un handle che rappresenta un nuovo gruppo che contiene tutti gli elementi del primo gruppo che non sono presenti nel secondo gruppo. La funzione restituisce MPI_GROUP_EMPTY se il nuovo gruppo è vuoto.
Valore restituito
Restituisce MPI_SUCCESS sull'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_DIFFERENCE(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, in cui vengono 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 HPC Pack 2012 MS-MPI Redistributable Package, HPC Pack 2008 R2 MS-MPI Redistributable Package, HPC Pack 2008 MS-MPI Redistributable Package o HPC Pack 2008 Utilità client |
Intestazione |
Mpi.h; Mpif.h |
Libreria |
Msmpi.lib |
DLL |
Msmpi.dll |