共用方式為


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_blocklengthsarray_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