MPI_GROUP_RANGE_EXCL(3)MPI_GROUP_RANGE_EXCL(3)NAME
MPI_Group_range_excl - Produces a group by excluding ranges of processes
from an existing group
SYNOPSIS
C:
#include <mpi.h>
int MPI_Group_range_excl ( group, n, ranges, newgroup )
MPI_Group group, *newgroup;
int n, ranges[][3];
C++:
#include <mpi.h>
Group Group::Range_excl(
int n,
const int ranges[3][]) const
Fortran:
INCLUDE "mpif.h" (or USE MPI)
INTEGER group, n, ranges(3,*), newgroup, ierror
CALL MPI_GROUP_RANGE_EXCL(group, n, ranges(3,*), newgroup, ierror)
STANDARDS
This release implements the MPI 1.2 standard, as documented by the MPI
Forum in the spring 1997 release of MPI: A Message Passing Interface
Standard.
DESCRIPTION
The MPI_Group_range_excl routine produces a group by excluding ranges of
processes from an existing group. This routine accepts the following
parameters:
group Specifies the group (handle).
n Specifies the number of elements in array ranges (integer).
ranges Specifies a one-dimensional array of integer triplets of the
form (first rank, last rank, stride), indicating the ranks in a
group of processes to be excluded from the output group
newgroup.
Page 1
MPI_GROUP_RANGE_EXCL(3)MPI_GROUP_RANGE_EXCL(3)
newgroup Returns a new group derived from ranges, preserving the order
in group (handle).
ierror Specifies the return code value for successful completion,
which is in MPI_SUCCESS. MPI_SUCCESS is defined in the mpif.h
file.
NOTES
According to the current draft standard, each of the ranks to exclude
must be a valid rank in the group and all elements must be distinct, or
the result is erroneous.
Page 2