MPI_TYPE_VECTOR, MPI_Type_vector

Purpose

Returns a new datatype that represents equally spaced blocks. The spacing
between the start of each block is given in units of extent (oldtype).

C synopsis

#include <mpi.h>
int MPI_Type_vector(int count,int blocklength,int stride,
                    MPI_Datatype oldtype,MPI_Datatype *newtype);

C++ synopsis

#include mpi.h
MPI::Datatype MPI::Datatype::Create_vector(int count, int blocklength,
                                           int stride) const;

FORTRAN synopsis

include 'mpif.h' or use mpi
MPI_TYPE_VECTOR(INTEGER COUNT,INTEGER BLOCKLENGTH,INTEGER STRIDE,
                INTEGER OLDTYPE,INTEGER NEWTYPE,INTEGER IERROR)

Parameters

count
     is the number of blocks (non-negative integer) (IN)

blocklength
     is the number of oldtype instances in each block (non-negative
     integer) (IN)

stride
     is the number of units between the start of each block (integer) (IN)

oldtype
     is the old datatype (handle) (IN)

newtype
     is the new datatype (handle) (OUT)

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

Description

This subroutine returns a new datatype that represents count equally spaced
blocks. Each block is a a concatenation of blocklength instances of
oldtype. The origins of the blocks are spaced stride units apart, where the
counting unit is extent(oldtype). That is, from one origin to the next in
bytes = stride * extent (oldtype).

Notes

newtype must be committed using MPI_TYPE_COMMIT before being used for
communication.

Errors

Invalid count
     count < 0

Invalid blocklength
     blocklength < 0

Undefined oldtype

Oldtype is MPI_LB, MPI_UB or MPI_PACKED

MPI not initialized

MPI already finalized

Related information

     MPI_TYPE_COMMIT
     MPI_TYPE_FREE
     MPI_TYPE_GET_CONTENTS
     MPI_TYPE_GET_ENVELOPE