função MPI_Group_difference
Cria um novo grupo a partir da diferença entre dois grupos existentes.
Sintaxe
int MPIAPI MPI_Group_difference(
MPI_Group group1,
MPI_Group group2,
_Out_ MPI_Group *newgroup
);
Parâmetros
grupo1
O primeiro grupo.grupo2
O segundo grupo.newgroup [out]
Um ponteiro para uma alça que representa um novo grupo que contém todos os elementos no primeiro grupo que não estão presentes no segundo grupo. A função devolve MPI_GROUP_EMPTY se o novo grupo estiver vazio.
Valor devolvido
Devolve MPI_SUCCESS com êxito. Caso contrário, o valor devolvido é um código de erro.
Em Fortran, o valor devolvido é armazenado no parâmetro IERROR .
Fortran
MPI_GROUP_DIFFERENCE(GROUP1, GROUP2, NEWGROUP, IERROR)
INTEGER GROUP1, GROUP2, NEWGROUP, IERROR
Observações
Esta é uma operação local. Diferentes processos podem definir grupos distintos. Um processo pode definir um grupo que não se inclui a si próprio.
A implementação do MPI não fornece um mecanismo para criar um grupo de raiz, mas apenas a partir de grupos existentes. O grupo base, no qual todos os outros grupos são definidos, pode ser obtido com a função MPI_Comm_group . É o grupo que está associado ao comunicador inicial MPI_COMM_WORLD.
Requisitos
Produto |
HPC Pack 2012 MS-MPI Redistributable Package, HPC Pack 2008 R2 MS-MPI Redistributable Package, HPC Pack 2008 MS-MPI Redistributable Package ou HPC Pack 2008 Client Utilities |
Cabeçalho |
Mpi.h; Mpif.h |
Biblioteca |
Msmpi.lib |
DLL |
Msmpi.dll |