Condividi tramite


funzione MPI_Group_excl

Costruttore di gruppo utilizzato per definire un nuovo gruppo eliminando i ranghi da un gruppo esistente.

Sintassi

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

Parametri

  • utenti
    Gruppo esistente.

  • n
    Numero di elementi nel parametro di classificazione .

  • Ranghi
    Matrici di processi nel gruppo che non devono essere visualizzati in newgroup. I ranghi specificati devono essere validi nel gruppo esistente. Ogni elemento nella matrice deve essere distinto. Se la matrice è vuota, il nuovo gruppo sarà identico al gruppo esistente.

  • newgroup [out]
    Puntatore a un handle che rappresenta il nuovo gruppo derivato dal gruppo esistente. L'ordine del gruppo esistente viene mantenuto nel nuovo gruppo.

Valore restituito

Restituisce MPI_SUCCESS in caso di 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_EXCL(GROUP, N, RANKS, NEWGROUP, IERROR)
        INTEGER GROUP, N, RANKS(*), NEWGROUP, IERROR

Commenti

Questa funzione crea un nuovo gruppo di processi derivati rimuovendo i processi specificati da un gruppo esistente mantenendo l'ordine dei ranghi nel gruppo.

Requisiti

Prodotto

Pacchetto ridistribuibile DI HPC Pack 2012 MS-MPI, HPC Pack 2008 R2 MS-MPI Redistributable Package, HPC Pack 2008 MS-MPI Redistributable Package o utilità client HPC Pack 2008

Intestazione

Mpi.h; Mpif.h

Libreria

Msmpi.lib

DLL

Msmpi.dll

Vedi anche

Funzioni di gruppo MPI