MPI_Type_create_hvector function

Article
09/14/2018

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

Share via