---
title: 预留接口
description: "本章接口为预留接口，后续有可能变更或废弃，不建议开发者使用，开发者无需关注。"
url: https://www.hiascend.com/document/detail/zh/canncommercial/latest/API/aolapi/atlasascendc_api_07_1093.html
sourcePath: /source/zh/canncommercial/900/API/aolapi/atlasascendc_api_07_1093.html
indexId: e7176f7c5a646e57feab90b40ec6e35815dff0491fa6d6e0fefe11c20ca61ada70
---
# 预留接口

本章接口为预留接口，后续有可能变更或废弃，不建议开发者使用，开发者无需关注。


**表1 接口列表**

| 接口名称 | 功能说明 |
| --- | --- |
| InitTensor(const int64\_t \*viewDims, uint64\_t viewDimsNum, aclDataType dataType, const int64\_t \*stride, int64\_t offset, aclFormat format, const int64\_t \*storageDims, uint64\_t storageDimsNum, void \*tensorDataAddr) | 重置一个aclTensor的各项属性。 |
| ToString(op::DataType dataType) | 获取数据类型对应字符串表示。 |
| TypeSize(DataType dataType) | 获取数据类型位宽。 |
| ToContiguousStrides(const op::Shape &shape, op::Strides &strides) | 根据shape推导连续tensor的stride。 |
| aclStorage() | aclStorage的构造函数，aclStorage用于描述一块片上内存空间。 |
| aclStorage(void \*addr) | aclStorage的构造函数，aclStorage用于描述一块片上内存空间。 |
| aclStorage(bool fromWorkspace) | aclStorage的构造函数，aclStorage用于描述一块片上内存空间。 |
| aclStorage(void \*addr, bool fromWorkspace) | aclStorage的构造函数，aclStorage用于描述一块片上内存空间。 |
| GetAddr() | 获取Storage表示的片上内存地址指针。 |
| SetAddr(void \*addr) | 设置Storage表示的片上内存地址指针。 |
| SetWorkspaceOffset(uint64\_t offset) | 当Storage表示一块workspace时，设置其有效数据在device存储内存的偏移。 |
| GetWorkspaceOffset() | 当Storage表示一块workspace时，获取其有效数据在device存储内存的偏移。 |
| SetFromWorkspace(bool fromWorkspace) | 设置Storage是否表示一块workspace。 |
| SetFromWorkspace(bool from\_workspace) | 设置aclTensor表示一块workspace。 |
| IsFromWorkspace() | 获取Storage是否表示一块workspace。 |
| SetExtend(void \*extend) | 设置extend成员变量内容。 |
| GetExtend() | 获取extend成员变量内容。 |
| SetStorageOffset(int64\_t offset) | 设置Storage有效数据在指向device存储内存上的偏移。 |
| GetStorageOffset() | 获取Storage有效数据在指向device存储内存上的偏移。 |
| aclArray() | aclArray构造函数，aclArray用于描述一个host侧数组。 |
| Size() | 获取aclArray的大小。 |
| GetData() | 获取aclArray的数据区指针。 |
| ToString() | 获取aclArray内容的打印字符串。 |
| aclArray(const T \*value, uint64\_t size) | aclArray构造函数，aclArray用于描述一个host侧数组。 |
| aclTensor(aclTensor &&other) | 禁止aclTensor的该类构造函数。 |
| GetTensor() | 获取aclTensor中保存的gert::Tensor。 说明： gert::Tensor介绍参见《基础数据结构和接口(https://www.hiascend.com/document/detail/zh/canncommercial/900/maintenref/basicdataapi/atlasopapi\_07\_00001.html)》中“gert::Tensor(https://www.hiascend.comdocument/detail/zh/canncommercial/900/maintenref/basicdataapi/atlasopapi\_07\_00195.html)”。 |
| GetStorageAddr() | 获取aclTensor内部aclStorage指向的片上内存指针。 |
| GetStorage() | 获取aclTensor内部的aclStorage。 |
| GetViewOffset() | 获取aclTensor的ViewOffset。 |
| SetStorageAddr(void \*addr) | 设置aclTensor内部aclStorage指向的片上内存指针。 |
| SetViewOffset(int64\_t offset) | 设置aclTensor的ViewOffset。 |
| GetPlacement() | 获取aclTensor的类型，例如device侧tensor和host侧tensor。 |
| aclTensor(const int64\_t \*viewDims, uint64\_t viewDimsNum, aclDataType dataType, const int64\_t \*stride, int64\_t offset, const aclFormat format, const int64\_t \*storageDims, uint64\_t storageDimsNum, void \*tensorDataAddr) | aclTensor用于描述一块张量，包括device侧tensor与host侧tensor两种。可以描述tensor的shape、dtype、format等属性，并记录数据所处位置。 |
| aclTensor(op::DataType dataType, op::Format storageFormat, op::Format originFormat) | aclTensor用于描述一块张量，包括device侧tensor与host侧tensor两种。可以描述tensor的shape、dtype、format等属性，并记录数据所处位置。 |
| aclTensor(const op::Shape &shape, op::DataType dataType, op::Format format, void \*tensorDataAddr) | aclTensor用于描述一块张量，包括device侧tensor与host侧tensor两种。可以描述tensor的shape、dtype、format等属性，并记录数据所处位置。 |
| aclTensor(const op::Shape &storageShape, const op::Shape &originShape, op::DataType dataType, op::Format storageFormat, op::Format originFormat, void \*tensorDataAddr) | aclTensor用于描述一块张量，包括device侧tensor与host侧tensor两种。可以描述tensor的shape、dtype、format等属性，并记录数据所处位置。 |
| aclTensor(const op::Shape &shape, op::DataType dataType, op::Format format) | aclTensor用于描述一块张量，包括device侧tensor与host侧tensor两种。可以描述tensor的shape、dtype、format等属性，并记录数据所处位置。 |
| aclTensor(const op::Shape &storageShape, const op::Shape &originShape, op::DataType dataType, op::Format storageFormat, op::Format originFormat) | aclTensor用于描述一块张量，包括device侧tensor与host侧tensor两种。可以描述tensor的shape、dtype、format等属性，并记录数据所处位置。 |
| aclTensor(const aclTensor &other, const op::Shape &shape, int64\_t offset) | aclTensor用于描述一块张量，包括device侧tensor与host侧tensor两种。可以描述tensor的shape、dtype、format等属性，并记录数据所处位置。 |
| aclTensor(const aclIntArray \*value, op::DataType dataType) | aclTensor用于描述一块张量，包括device侧tensor与host侧tensor两种。可以描述tensor的shape、dtype、format等属性，并记录数据所处位置。 |
| aclTensor(const aclBoolArray \*value, op::DataType dataType) | aclTensor用于描述一块张量，包括device侧tensor与host侧tensor两种。可以描述tensor的shape、dtype、format等属性，并记录数据所处位置。 |
| aclTensor(const aclFloatArray \*value, op::DataType dataType) | aclTensor用于描述一块张量，包括device侧tensor与host侧tensor两种。可以描述tensor的shape、dtype、format等属性，并记录数据所处位置。 |
| aclTensor(const aclFp16Array \*value, op::DataType dataType) | aclTensor用于描述一块张量，包括device侧tensor与host侧tensor两种。可以描述tensor的shape、dtype、format等属性，并记录数据所处位置。 |
| aclTensor(const aclBf16Array \*value, op::DataType dataType) | aclTensor用于描述一块张量，包括device侧tensor与host侧tensor两种。可以描述tensor的shape、dtype、format等属性，并记录数据所处位置。 |
| aclTensor() | aclTensor用于描述一块张量，包括device侧tensor与host侧tensor两种。可以描述tensor的shape、dtype、format等属性，并记录数据所处位置。 |
| aclTensor(const T \*value, uint64\_t size, op::DataType dataType) | aclTensor用于描述一块张量，包括device侧tensor与host侧tensor两种。可以描述tensor的shape、dtype、format等属性，并记录数据所处位置。 |
| aclTensor(const aclScalar \*value, op::DataType dataType) | aclTensor用于描述一块张量，包括device侧tensor与host侧tensor两种。可以描述tensor的shape、dtype、format等属性，并记录数据所处位置。 |
| IsView() | 获取aclTensor是否为view类tensor。 |
| SetView(bool is\_view) | 设置aclTensor是否为view类tensor。 |
| aclTensorList(const aclTensor \*const \*tensors, uint64\_t size) | aclTensorList表示一个aclTensor数组，该函数为其构造函数。 |
| aclTensorList() | aclTensorList表示一个aclTensor数组，该函数为其构造函数。 |
| aclScalar(const void \*data, op::DataType dataType) | aclScalar表示一个标量数字，该函数为其构造函数。 |
| aclScalar() | aclScalar表示一个标量数字，该函数为其构造函数。 |
| ToFloat() | 将aclScalar中保存的标量，转为指定的数据类型。 |
| ToDouble() | 将aclScalar中保存的标量，转为指定的数据类型。 |
| ToBool() | 将aclScalar中保存的标量，转为指定的数据类型。 |
| ToInt8() | 将aclScalar中保存的标量，转为指定的数据类型。 |
| ToInt16() | 将aclScalar中保存的标量，转为指定的数据类型。 |
| ToInt32() | 将aclScalar中保存的标量，转为指定的数据类型。 |
| ToInt64() | 将aclScalar中保存的标量，转为指定的数据类型。 |
| ToUint8() | 将aclScalar中保存的标量，转为指定的数据类型。 |
| ToUint16() | 将aclScalar中保存的标量，转为指定的数据类型。 |
| ToUint32() | 将aclScalar中保存的标量，转为指定的数据类型。 |
| ToUint64() | 将aclScalar中保存的标量，转为指定的数据类型。 |
| ToFp16() | 将aclScalar中保存的标量，转为指定的数据类型。 |
| ToBf16() | 将aclScalar中保存的标量，转为指定的数据类型。 |
| ToComplex64() | 将aclScalar中保存的标量，转为指定的数据类型。 |
| ToComplex128() | 将aclScalar中保存的标量，转为指定的数据类型。 |
| aclScalar(int32\_t value) | 通过指定类型的标量，初始化aclScalar对象。 |
| aclScalar(int64\_t value) | 通过指定类型的标量，初始化aclScalar对象。 |
| aclScalar(int16\_t value) | 通过指定类型的标量，初始化aclScalar对象。 |
| aclScalar(int8\_t value) | 通过指定类型的标量，初始化aclScalar对象。 |
| aclScalar(uint32\_t value) | 通过指定类型的标量，初始化aclScalar对象。 |
| aclScalar(uint64\_t value) | 通过指定类型的标量，初始化aclScalar对象。 |
| aclScalar(uint16\_t value) | 通过指定类型的标量，初始化aclScalar对象。 |
| aclScalar(uint8\_t value) | 通过指定类型的标量，初始化aclScalar对象。 |
| aclScalar(float value) | 通过指定类型的标量，初始化aclScalar对象。 |
| aclScalar(double value) | 通过指定类型的标量，初始化aclScalar对象。 |
| aclScalar(op::fp16\_t value) | 通过指定类型的标量，初始化aclScalar对象。 |
| aclScalar(op::bfloat16 value) | 通过指定类型的标量，初始化aclScalar对象。 |
| aclScalar(bool value) | 通过指定类型的标量，初始化aclScalar对象。 |
| To() | 将aclScalar中保存的标量，转为T数据类型。 |
| ToStr() | 生成描述aclScalar的字符串。 |
| BFloat16() | 将aclScalar中保存的标量，转为bfloat16。 |
| aclScalarList(const aclScalar \*const \*scalars, uint64\_t size) | aclScalarList表示一个aclScalar数组，该函数为其构造函数。 |
| aclScalarList() | aclScalarList表示一个aclScalar数组，该函数为其构造函数。 |
| ToString(const aclTensor\* t) | 打印函数，针对不同数据类型，生成可以描述其内容的字符串。 |
| ToString(const aclTensorList\* t) | 打印函数，针对不同数据类型，生成可以描述其内容的字符串。 |
| ToString(const aclIntArray\* t) | 打印函数，针对不同数据类型，生成可以描述其内容的字符串。 |
| ToString(const aclBoolArray\* t) | 打印函数，针对不同数据类型，生成可以描述其内容的字符串。 |
| ToString(const aclFloatArray\* t) | 打印函数，针对不同数据类型，生成可以描述其内容的字符串。 |
| ToString(const aclFp16Array\* t) | 打印函数，针对不同数据类型，生成可以描述其内容的字符串。 |
| ToString(const aclBf16Array\* t) | 打印函数，针对不同数据类型，生成可以描述其内容的字符串。 |
| ToString(const aclScalar\* t) | 打印函数，针对不同数据类型，生成可以描述其内容的字符串。 |
| ToString(const aclScalarList\* t) | 打印函数，针对不同数据类型，生成可以描述其内容的字符串。 |
| ToString(const aclTensor& t) | 打印函数，针对不同数据类型，生成可以描述其内容的字符串。 |
| ToString(const aclTensorList& t) | 打印函数，针对不同数据类型，生成可以描述其内容的字符串。 |
| ToString(const aclIntArray& t) | 打印函数，针对不同数据类型，生成可以描述其内容的字符串。 |
| ToString(const aclBoolArray& t) | 打印函数，针对不同数据类型，生成可以描述其内容的字符串。 |
| ToString(const aclFloatArray& t) | 打印函数，针对不同数据类型，生成可以描述其内容的字符串。 |
| ToString(const aclFp16Array& t) | 打印函数，针对不同数据类型，生成可以描述其内容的字符串。 |
| ToString(const aclBf16Array& t) | 打印函数，针对不同数据类型，生成可以描述其内容的字符串。 |
| ToString(const aclScalar& t) | 打印函数，针对不同数据类型，生成可以描述其内容的字符串。 |
| ToString(const aclScalarList& t) | 打印函数，针对不同数据类型，生成可以描述其内容的字符串。 |
| ToString(aclDataType dataType) | 打印函数，针对不同数据类型，生成可以描述其内容的字符串。 |