Partilhar via


função MPI_Group_excl

Um construtor de grupo que é utilizado para definir um novo grupo ao eliminar 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 .

  • classificações
    As matrizes de processos no grupo que não serão apresentados no novo grupo. As classificações especificadas têm de ser válidas no grupo existente. Cada elemento na matriz tem de ser distinto. Se a matriz estiver vazia, o novo grupo será idêntico ao grupo existente.

  • newgroup [out]
    Um ponteiro para uma alça que representa o novo grupo derivado do grupo existente. A ordem do grupo existente é preservada no novo grupo.

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_EXCL(GROUP, N, RANKS, NEWGROUP, IERROR)
        INTEGER GROUP, N, RANKS(*), NEWGROUP, IERROR

Observações

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

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 do Grupo MPI