MPI_Group_excl function

A group constructor that is used to define a new group by deleting ranks from an existing group.

Syntax


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

Parameters

group

The existing group.

n

The number of elements in the ranks parameter.

ranks

The arrays of processes in group that are not to appear in newgroup. The specified ranks must be valid in the existing group. Each element in the array must be distinct. If the array is empty then the new group will be identical to the existing group.

newgroup [out]

A pointer to a handle that represents the new group that is derived from the existing group. The order of the existing group is preserved in the new group.

Return value

Returns MPI_SUCCESS on success. Otherwise, the return value is an error code.

In Fortran, the return value is stored in the IERROR parameter.

Fortran


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

Remarks

This function creates a new group of processes that is derived by removing specified processes from an existing group while preserving the order of the ranks in the group.

Requirements

Product

HPC Pack 2012 MS-MPI Redistributable Package, HPC Pack 2008 R2 MS-MPI Redistributable Package, HPC Pack 2008 MS-MPI Redistributable Package or HPC Pack 2008 Client Utilities

Header

Mpi.h;
Mpif.h

Library

Msmpi.lib

DLL

Msmpi.dll

See also

MPI Group Functions

 

 

Show: