跳到主要内容

aclGetTensorDescDimV2

aclGetTensorDescNumDims​

函数功能​

获取tensor描述中shape的维度个数。同步接口。

函数原型​

size_t aclGetTensorDescNumDims(const aclTensorDesc *desc)

参数说明​

参数名输入/输出说明
desc输入aclTensorDesc类型的指针。 需提前调用aclCreateTensorDesc接口创建aclTensorDesc类型。

返回值说明​

返回tensor描述中shape的维度个数。若返回ACL_UNKNOWN_RANK（#define ACL_UNKNOWN_RANK 0xFFFFFFFFFFFFFFFE）表示动态Shape场景下维度个数未知。

父主题： aclTensorDesc

aclGetTensorDescDim​

备注

须知

此接口后续版本会废弃，请使用aclGetTensorDescDimV2接口。

函数功能​

获取tensor描述中指定维度的大小。同步接口。

函数原型​

int64_t aclGetTensorDescDim(const aclTensorDesc *desc, size_t index)

参数说明​

参数名输入/输出说明
desc输入aclTensorDesc类型的指针。 需提前调用aclCreateTensorDesc接口创建aclTensorDesc类型。
index输入指定获取第几个维度的大小，index值从0开始。 用户调用aclGetTensorDescNumDims接口获取shape维度个数，这个Index的取值范围：[0, (shape维度个数-1)]。

返回值说明​

返回指定tensor描述中指定维度的大小。

父主题： aclTensorDesc

aclGetTensorDescDimV2​

函数功能​

获取tensor描述中指定维度的大小。同步接口。

约束说明​

当aclGetTensorDescNumDims接口的返回值为ACL_UNKNOWN_RANK时，表示动态Shape场景下维度个数未知，则不能调用aclGetTensorDescDimV2接口获取指定维度的大小。

函数原型​

aclError aclGetTensorDescDimV2(const aclTensorDesc *desc, size_t index, int64_t *dimSize)

参数说明​

参数名输入/输出说明
desc输入aclTensorDesc类型的指针。 需提前调用aclCreateTensorDesc接口创建aclTensorDesc类型。
index输入指定获取第几个维度的大小，index值从0开始。 用户调用aclGetTensorDescNumDims接口获取shape维度个数，这个Index的取值范围：[0, (shape维度个数-1)]。
dimSize输出tensor描述中index指定维度大小的指针。 当返回的dimSize参数值为-1时，表示维度的大小是动态的。

返回值说明​

返回0表示成功，返回其它值表示失败。

父主题： aclTensorDesc

aclGetTensorDescDimRange​

函数功能​

获取tensor描述中指定维度的范围，[1,-1]表示全shape范围。同步接口。

约束说明​

当aclGetTensorDescNumDims接口的返回值为ACL_UNKNOWN_RANK时，表示动态Shape场景下维度个数未知，则不能调用aclGetTensorDescDimRange接口获取指定维度的范围。

函数原型​

aclError aclGetTensorDescDimRange(const aclTensorDesc *desc, size_t index, size_t dimRangeNum, int64_t *dimRange)

参数说明​

参数名输入/输出说明
desc输入aclTensorDesc类型的指针。 需提前调用aclCreateTensorDesc接口创建aclTensorDesc类型。
index输入指定获取第几个维度的大小，index值从0开始。 用户调用aclGetTensorDescNumDims接口获取shape维度个数，这个Index的取值范围：[0, (shape维度个数-1)]。
dimRangeNum输入dimRange的长度，该值必须大于等于2。
dimRange输出tensor描述中index指定维度的Shape范围。 dimRange是一个数组，数组的第一个元素值表示Shape范围的最小值，第二个元素值表示Shape范围的最大值。该数组中仅前2个元素值有效。 当dimRange数组的值为[1,-1]时，表示全Shape范围。

返回值说明​

返回0表示成功，返回其它值表示失败。

父主题： aclTensorDesc

aclSetTensorDescName​

函数功能​

设置TensorDesc的名称。同步接口。

函数原型​

void aclSetTensorDescName(aclTensorDesc *desc, const char *name)

参数说明​

参数名输入/输出说明
desc输出aclTensorDesc类型的指针。 需提前调用aclCreateTensorDesc接口创建aclTensorDesc类型。
name输入TensorDesc名称的指针。

返回值说明​

无

父主题： aclTensorDesc

在线提单