Partilhar via


função MPI_Group_intersection

Cria um novo grupo a partir da interseção de dois grupos existentes.

Sintaxe

int MPIAPI MPI_Group_intersection(
        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 um identificador que representa um novo grupo com os elementos que estão presentes em ambos os grupos. 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_INTERSECTION(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 do zero, 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 MPI_COMM_WORLD do comunicador inicial.

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

Ver também

Funções de Grupo de MPI

MPI_Comm_group