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.
     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.