MPI_GROUP_DIFFERENCE, MPI_Group_difference

Purpose

Creates a new group that is the difference of two existing groups.

C synopsis

#include <mpi.h>
int MPI_Group_difference(MPI_Group group1,MPI_Group group2,
    MPI_Group *newgroup);

C++ synopsis

#include mpi.h
static MPI::Group MPI::Group::Difference(const MPI::Group& group1,
                                         const MPI::Group& group2);

FORTRAN synopsis

include 'mpif.h' or use mpi
MPI_GROUP_DIFFERENCE(INTEGER GROUP1,INTEGER GROUP2,
      INTEGER NEWGROUP,INTEGER IERROR)

Parameters

group1
     is the first group (handle) (IN)

group2
     is the second group (handle) (IN)

newgroup
     is the difference group (handle) (OUT)

IERROR
     is the FORTRAN return code. It is always the last argument.

Description

This subroutine creates a new group that is the difference of two existing
groups. The new group consists of all elements of the first group (group1)
that are not in the second group (group2), and is ordered as in the first
group.

Errors

Invalid group(s)

MPI not initialized

MPI already finalized

Related information

     MPI_GROUP_INTERSECTION