MPI_TYPE_CONTIGUOUS, MPI_Type_contiguous

Purpose

Returns a new datatype that represents the concatenation of count instances
of oldtype.

C synopsis

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

C++ synopsis

#include mpi.h
MPI::Datatype MPI::Datatype::Create_contiguous(int count) const;

FORTRAN synopsis

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

Parameters

count
     is the replication count (non-negative 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 the concatenation of
count instances of oldtype. MPI_TYPE_CONTIGUOUS allows replication of a
datatype into contiguous locations.

Notes

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

Errors

Invalid count
     count < 0

Undefined oldtype

Oldtype is MPI_LB, MPI_UB, or MPI_PACKED

Stride overflow

Extent overflow

Size overflow

Upper or lower bound overflow

MPI not initialized

MPI already finalized

Related information

     MPI_TYPE_COMMIT
     MPI_TYPE_FREE
     MPI_TYPE_GET_CONTENTS