MPI Subroutine Reference

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

MPI_TYPE_GET_ENVELOPE