MPI_GROUP_INTERSECTION, MPI_Group_intersection

Purpose

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

C synopsis

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

C++ synopsis

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

FORTRAN synopsis

include 'mpif.h' or use mpi
MPI_GROUP_INTERSECTION(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 intersection 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 intersection of two
existing groups. The new group consists of all elements of the first group
(group1) that are also part of 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_DIFFERENCE