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.
newgroup Returns a new group derived from ranges,
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.
Man(1) output converted with
man2html