Compartilhar via


função MPI_Group_excl

Um construtor de grupo usado para definir um novo grupo excluindo classificações de um grupo existente.

Sintaxe

int MPIAPI MPI_Group_excl(
        MPI_Group         group,
        int               n,
        _In_count_(n) int *ranks,
  _Out_ MPI_Group         *newgroup
);

Parâmetros

  • grupo
    O grupo existente.

  • n
    O número de elementos no parâmetro ranks .

  • Fileiras
    As matrizes de processos em grupo que não devem aparecer no newgroup. As classificações especificadas devem ser válidas no grupo existente. Cada elemento na matriz deve ser distinto. Se a matriz estiver vazia, o novo grupo será idêntico ao grupo existente.

  • newgroup [out]
    Um ponteiro para um identificador que representa o novo grupo derivado do grupo existente. A ordem do grupo existente é preservada no novo grupo.

Retornar valor

Retorna MPI_SUCCESS com êxito. Caso contrário, o valor retornado será um código de erro.

No Fortran, o valor retornado é armazenado no parâmetro IERROR .

Fortran

    MPI_GROUP_EXCL(GROUP, N, RANKS, NEWGROUP, IERROR)
        INTEGER GROUP, N, RANKS(*), NEWGROUP, IERROR

Comentários

Essa função cria um novo grupo de processos derivados da remoção de processos especificados de um grupo existente, preservando a ordem das classificações no grupo.

Requisitos

Produto

Pacote Redistribuível do HPC Pack 2012 MS-MPI, Pacote Redistribuível HPC Pack 2008 R2 MS-MPI, Pacote Redistribuível do HPC Pack 2008 MS-MPI ou Utilitários de Cliente HPC Pack 2008

parâmetro

Mpi.h; Mpif.h

Biblioteca

Msmpi.lib

DLL

Msmpi.dll

Confira também

Funções de grupo de MPI