MPI_Group_range_incl(3)

NAME
     MPI_Group_range_incl - Creates a new group from ranges of ranks in an
     existing group

SYNOPSIS
     C:

          #include <mpi.h>

          int MPI_Group_range_incl ( group, n, ranges, newgroup )
          MPI_Group group, *newgroup;
          int       n, ranges[][3];


     C++:

          #include <mpi.h>

          Group Group::Range_incl(
          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_INCL(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_incl routine creates a new group from ranges of ranks
     in an existing group.  This routine accepts the following parameters:

     group     Specifies the group (handle)

     n         Specifies the number of triplets in array ranges (integer)

     ranges    Specifies a one-dimensional array of integer triplets, of the
               form "first rank, last rank, stride," indicating ranks in the
               group or processes to be included in newgroup

     newgroup  Returns a new group derived from group, in the order defined by
               ranges (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
     Currently, this implementation does not check to determine if the list of
     ranges to include are valid ranks in the group.