MPI_GROUP_UNION, MPI_Group_union

Purpose

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

C synopsis

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

C++ synopsis

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

FORTRAN synopsis

include 'mpif.h' or use mpi
MPI_GROUP_UNION(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 union 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 union of two existing
groups. The new group consists of the elements of the first group (group1)
followed by all the elements of the second group (group2) not in the first
group.

Errors

Invalid group(s)

MPI not initialized

MPI already finalized

Related information

     MPI_GROUP_DIFFERENCE