função MPI_Type_create_struct

Artigo
09/28/2023

Define um novo tipo de dados com um tipo de dados, deslocamento e tamanho especificados para cada bloco de dados.

Sintaxe

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
);

Parâmetros

contagem
O número de blocos e o número de entradas nos parâmetros array_of_blocklengths, array_of_displacements e array_of_types .
array_of_blocklengths
O número de elementos de cada bloco.
array_of_displacements
A deslocação de cada bloco individual em bytes.
array_of_types
O tipo de dados de cada bloco individual.
newtype [out]
Em troca, contém uma MPI_Datatype identificador que representa o novo tipo de dados.

Valor devolvido

Devolve MPI_SUCCESS com êxito. Caso contrário, o valor devolvido é um código de erro.

Em Fortran, o valor devolvido é armazenado no parâmetro 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

Observações

Esta função substitui a função MPI_Type_struct , que foi preterida.

Requisitos

Produto	HPC Pack 2012 MS-MPI Redistributable Package, HPC Pack 2008 R2 MS-MPI Redistributable Package, HPC Pack 2008 MS-MPI Redistributable Package ou HPC Pack 2008 Client Utilities
Cabeçalho	Mpi.h; Mpif.h
Biblioteca	Msmpi.lib
DLL	Msmpi.dll