MPI_Type_create_keyval 函数

为 MPI 数据类型创建属性键值。

语法

int MPIAPI MPI_Type_create_keyval(
  _In_     MPI_Type_copy_attr_function   *type_copy_attr_fn,
  _In_     MPI_Type_delete_attr_function *type_delete_attr_fn,
  _Out_    int                           *type_keyval,
  _In_opt_ void                          *extra_state
);

参数

• type_copy_attr_fn [in]
  type_keyval的复制回调函数。

• type_delete_attr_fn [in]
  删除 type_keyval的回调函数。

• type_keyval [out]
  用于将来访问的键值。

• extra_state [in， 可选]
  回调函数的额外状态。

返回值

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

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

Fortran

    MPI_TYPE_CREATE_KEYVAL(TYPE_COPY_ATTR_FN, TYPE_DELETE_ATTR_FN, TYPE_KEYVAL,
                EXTRA_STATE, IERROR)
        EXTERNAL TYPE_COPY_ATTR_FN, TYPE_DELETE_ATTR_FN
        INTEGER TYPE_KEYVAL, IERROR
        INTEGER(KIND=MPI_ADDRESS_KIND) EXTRA_STATE

注解

默认的复制和删除函数可用。 这 4 种方式为：

• MPI_TYPE_NULL_COPY_FN - 空复制函数
• MPI_TYPE_NULL_DELETE_FN - 空删除函数
• MPI_TYPE_DUP_FN - 简单 dup 函数

要求

另请参阅

MPI 缓存函数

MPI_Type_copy_attr_function

MPI_Type_delete_attr_function