MPI_Type_create_hvector function

Defines a new data type that consists of a specified number of blocks. Each block is a concatenation of the same number of elements of an existing data type. This function is similar to the function MPI_Type_vector except that the stride is specified in bytes instead of the number of elements.

Syntax


int MPIAPI MPI_Type_create_hvector(
        int          count,
        int          blocklength,
        MPI_Aint     stride,
        MPI_Datatype oldtype,
  _Out_ MPI_Datatype *newtype
);

Parameters

count

The number of blocks in the new data type.

blocklength

The number of elements in each block.

stride

The number of bytes between the start of one block and the next. The stride is a multiple of the extent of the old data type.

oldtype

The MPI data type of each element.

newtype [out]

On return, contains an MPI_Datatype handle that represents the new data type.

Return value

Returns MPI_SUCCESS on success. Otherwise, the return value is an error code.

In Fortran, the return value is stored in the IERROR parameter.

Fortran


MPI_TYPE_CREATE_HVECTOR(COUNT, BLOCKLENGTH, STRIDE, OLDTYPE, NEWTYPE, IERROR)
    INTEGER COUNT, BLOCKLENGTH, STRIDE, OLDTYPE, NEWTYPE, IERROR

Remarks

This function replaces the MPI_Type_hvector function, which is deprecated.

Requirements

Product

HPC Pack 2012 MS-MPI Redistributable Package, HPC Pack 2008 R2 MS-MPI Redistributable Package, HPC Pack 2008 MS-MPI Redistributable Package or HPC Pack 2008 Client Utilities

Header

Mpi.h;
Mpif.h

Library

Msmpi.lib

DLL

Msmpi.dll

See also

MPI Datatype Functions
MPI_Type_contiguous
MPI_Type_vector

 

 

Show: