数据类型
函数定义
- 创建连续的数据类型。
MPI_Type_contiguous(int count, MPI_Datatype oldtype, MPI_Datatype *newtype)
PMPI_Type_contiguous(int count, MPI_Datatype oldtype, MPI_Datatype *newtype)
- 创建矢量数据类型。
MPI_Type_vector(int count, int blocklength, int stride, MPI_Datatype oldtype, MPI_Datatype *newtype)
PMPI_Type_vector(int count, int blocklength, int stride, MPI_Datatype oldtype, MPI_Datatype *newtype)
- 创建偏移量位的矢量数据类型。
MPI_Type_create_hvector(int count, int blocklength, MPI_Aint stride, MPI_Datatype oldtype, MPI_Datatype *newtype)
PMPI_Type_create_hvector(int count, int blocklength, MPI_Aint stride, MPI_Datatype oldtype, MPI_Datatype *newtype)
- 创建描述n维数组的子数组的数据类型。
MPI_Type_create_subarray(int ndims, const int sizeArray[], const int subSizeArray[], const int subStartArray[], int order, MPI_Datatype oldtype, MPI_Datatype *newtype)
PMPI_Type_create_subarray(int ndims, const int sizeArray[], const int subSizeArray[], const int subStartArray[], int order, MPI_Datatype oldtype, MPI_Datatype *newtype)
- 提交数据类型。
MPI_Type_commit(MPI_Datatype *type)
PMPI_Type_commit(MPI_Datatype *type)
- 复制具有关联键值的数据类型。
MPI_Type_dup(MPI_Datatype oldtype, MPI_Datatype *newtype)
PMPI_Type_dup(MPI_Datatype oldtype, MPI_Datatype *newtype)
- 释放自定义数据类型。
MPI_Type_free(MPI_Datatype *type)
PMPI_Type_free(MPI_Datatype *type)
参数
参数名 |
描述 |
取值范围 |
输入/输出 |
|---|---|---|---|
count |
块数 |
正整数 |
输入 |
blocklength |
每个块中的元素个数 |
正整数 |
输入 |
stride |
每个块开始之间的元素数 |
正整数 |
输入 |
ndims |
数组维度数 |
正整数[1, 10] |
输入 |
order |
数组存储顺序标志 |
正整数（MPI_ODER_C、MPI_ODER_FORTRAN） |
输入 |
sizeArray[] |
完整数组的每个维度中oldtype类型的元素数 |
正整数数组 |
输入 |
subSizeArray[] |
子数组的每个维度中oldtype类型的元素数 |
正整数数组 |
输入 |
subStartArray[] |
每个维度中子数组的起始坐标 |
非负数数组 |
输入 |
oldtype |
旧数据类型（句柄） |
有效句柄 |
输入 |
*newtype |
目标地址，存放新的类型（句柄） |
非空 |
输出 |
*type |
释放的自定义数据类型（句柄） |
非空 |
输入 |
返回值
- 成功：返回MPI_SUCCESS。
- 失败：返回错误码。
错误码
错误码 |
描述 |
|---|---|
MPI_ERR_COUNT |
无效count参数 |
MPI_ERR_TYPE23 |
无效数据类型参数 |
MPI_ERR_ARG |
其他类型的无效参数 |
MPI_ERR_OTHER |
其他错误 |
注意
- oldtype目前仅支持MPI基本数据类型。
- count *（oldtype字节数）必须<=INT_MAX。
- blocklength * count *（oldtype字节数）必须<=INT_MAX。