MPI_GROUP_COMPARE, MPI_Group_compare

Purpose

Compares the contents of two task groups.

C synopsis

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

C++ synopsis

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

FORTRAN synopsis

include 'mpif.h' or use mpi
MPI_GROUP_COMPARE(INTEGER GROUP1,INTEGER GROUP2,INTEGER RESULT,
    INTEGER IERROR)

Parameters

group1
     is the first group (handle) (IN)

group2
     is the second group (handle) (IN)

result
     is the result (integer) (OUT)

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

Description

This subroutine compares the contents of two task groups and returns one of
the following:

MPI_IDENT
     both groups have the exact group members and group order

MPI_SIMILAR
     group members are the same but group order is different

MPI_UNEQUAL
     group size is different or group members are different, or both

Errors

Invalid group(s)

MPI not initialized

MPI already finalized

Related information