MPI_Type_create_struct 函数

定义具有每个数据块的指定数据类型、位移和大小的新数据类型。

语法

int MPIAPI MPI_Type_create_struct(
        int                            count,
        _In_count_(count) int          array_of_blocklengths[],
        _In_count_(count) MPI_Aint     array_of_displacements[],
        _In_count_(count) MPI_Datatype array_of_types[],
  _Out_ MPI_Datatype                   *newtype
);

参数

  • 计数
    array_of_blocklengths、array_of_displacementsarray_of_types参数中的块数和条目数

  • array_of_blocklengths
    每个块的元素数。

  • array_of_displacements
    每个单独块的位移(以字节为单位)。

  • array_of_types
    每个块的数据类型。

  • newtype [out]
    返回时,包含表示新数据类型 的MPI_Datatype 句柄。

返回值

返回成功 时MPI_SUCCESS 。 否则,返回值为错误代码。

在 Fortran 中,返回值存储在 IERROR 参数中。

Fortran

    MPI_TYPE_CREATE_STRUCT(COUNT, ARRAY_OF_BLOCKLENGTHS, ARRAY_OF_DISPLACEMENTS, ARRAY_OF_TYPES, NEWTYPE, IERROR)
        COUNT, ARRAY_OF_BLOCKLENGTHS, ARRAY_OF_DISPLACEMENTS, ARRAY_OF_TYPES, NEWTYPE, IERROR

注解

此函数替换已弃用 的 MPI_Type_struct 函数。

要求

产品

HPC Pack 2012 MS-MPI 可再发行程序包、HPC Pack 2008 R2 MS-MPI 可再发行程序包、HPC Pack 2008 MS-MPI 可再发行程序包或 HPC Pack 2008 客户端实用工具

标头

Mpi.h;Mpif.h

Msmpi.lib

DLL

Msmpi.dll

另请参阅

MPI 数据类型函数

MPI_Type_indexed

MPI_Type_create_hindexed

MPI_Type_create_indexed_block