SYNTAX

C Syntax

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

Fortran Syntax

INCLUDE 'mpif.h'
MPI_TYPE_HVECTOR(COUNT, BLOCKLENGTH, STRIDE, OLDTYPE, NEWTYPE,
                IERROR)
        INTEGER COUNT, BLOCKLENGTH, STRIDE, OLDTYPE 
        INTEGER NEWTYPE, IERROR 

INPUT PARAMETERS

count

Number of blocks (nonnegative integer).

blocklength

Number of elements in each block (nonnegative integer).

stride

Number of bytes between start of each block (integer).

oldtype

Old datatype (handle).

OUTPUT PARAMETERS

newtype

New datatype (handle).

IERROR

Fortran only: Error status (integer).

DESCRIPTION

This deprecated routine is not available in C++.

The function MPI_Type_hvector is identical to MPI_Type_vector, except that stride is given in bytes, rather than in elements. The use for both types of vector constructors is illustrated in the examples in Section 3.12.7 of the MPI-1 Standard.

Assume that oldtype has type map

    {(type(0), disp(0)), ..., (type(n-1), disp(n-1))}

with extent ex. Let bl be the blocklength. The newly created datatype has a type map with count * bl * n entries:

  {(type(0), disp(0)), ..., (type(n-1), disp(n-1)),
  (type(0), disp(0) + ex), ..., (type(n-1), disp(n-1) + ex), 
  ..., (type(0), disp(0) + (bl -1) * ex),...,(type(n-1), 
  disp(n-1) + (bl -1) * ex), (type(0), disp(0) + stride), 
  ...,(type(n-1), disp(n-1) + stride), ..., (type(0), 
  disp(0) + stride + (bl - 1) * ex), ..., (type(n-1), 
  disp(n-1) + stride + (bl -1) * ex), ..., (type(0), 
  disp(0) + stride * (count -1)), ...,(type(n-1), 
  disp(n-1) + stride * (count -1)), ..., (type(0), 
  disp(0) + stride * (count -1) + (bl -1) * ex), ..., 
  (type(n-1), disp(n-1) + stride * (count -1) + (bl -1) * ex)}