函数：get_data_buffer_addr
函数：float_to_float16
| C函数原型 | aclFloat16 aclFloatToFloat16(float value) |
|---|---|
| Python函数 | output = acl.float_to_float16(value) |
| 函数功能 | 将float（指float32）类型的数据转换为aclFloat16类型的数据。 |
| 输入说明 | value：float，待转化的数据。 |
| 返回值说明 | output：int，aclFloat16类型的数据。 |
| 约束说明 | 无 |
父主题： 公共接口
函数：create_data_buffer
| C函数原型 | aclDataBuffer *aclCreateDataBuffer(void *data, size_t size) |
|---|---|
| Python函数 | output = acl.create_data_buffer(data, size) |
| 函数功能 | 创建aclDataBuffer类型的数据，该数据类型用于描述内存地址、大小等内存信息。同步接口。 如需销毁aclDataBuffer类型的数据，请参见函数：destroy_data_buffer。 |
| 输入说明 | data：int，表述存储aclDataBuffer数据的指针地址。“data”参数支持传入0，表示创建一个空的数据类型，此时“size”参数值无效。该地址对象对应的数据内存需由用户自行管理，调用acl.rt.malloc接口申请内存，调用acl.rt.free接口释放内存。 size：int，内存大小。如果用户需要使用空Tensor，则在申请内存时，内存大小最小为1Byte，以保障后续业务正常运行。 |
| 返回值说明 | output：int， 输出aclDataBuffer的指针地址。 |
| 约束说明 | 无 |
父主题： 公共接口
函数：destroy_data_buffer
| C函数原型 | aclError aclDestroyDataBuffer(const aclDataBuffer *dataBuffer) |
|---|---|
| Python函数 | ret = acl.destroy_data_buffer(data_buffer) |
| 函数功能 | 销毁aclDataBuffer类型的数据。 此处仅销毁aclDataBuffer类型的数据，调用acl.create_data_buffer接口创建aclDataBuffer类型数据时传入的data的内存需由用户自行释放。 |
| 输入说明 | data_buffer：int，表述aclDataBuffer的指针地址。 |
| 返回值说明 | ret：int，错误码。 - 返回0表示成功。 - 返回其它值表示失败。 |
| 约束说明 | 无 |
父主题： 公共接口
函数：get_data_buffer_addr
| C函数原型 | void *aclGetDataBufferAddr(const aclDataBuffer *dataBuffer) |
|---|---|
| Python函数 | output = acl.get_data_buffer_addr(data_buffer) |
| 函数功能 | 获取aclDataBuffer类型中的数据的内存地址。 |
| 输入说明 | data_buffer：int，表述aclDataBuffer的指针地址。 |
| 返回值说明 | output：int，aclDataBuffer类型中的数据的指针地址。 |
| 约束说明 | 无 |
父主题： 公共接口
函数：get_data_buffer_size
备注
须知
此接口后续版本会废弃，请使用acl.get_data_buffer_size_v2接口。
| C函数原型 | size_t aclGetDataBufferSize(const aclDataBuffer *dataBuffer) |
|---|---|
| Python函数 | size = acl.get_data_buffer_size(data_buffer) |
| 函数功能 | 获取aclDataBuffer类型中数据的内存大小，单位Byte。 |
| 输入说明 | data_buffer：int，aclDataBuffer的指针地址。 |
| 返回值说明 | size：int，aclDataBuffer类型中数据的内存大小。 |
| 约束说明 | 无 |
父主题： 公共接口
函数：get_data_buffer_size_v2
| C函数原型 | size_t aclGetDataBufferSizeV2(const aclDataBuffer *dataBuffer) |
|---|---|
| Python函数 | size = acl.get_data_buffer_size_v2(data_buffer) |
| 函数功能 | 获取aclDataBuffer类型中数据的内存大小，单位Byte。 |
| 输入说明 | data_buffer：int，aclDataBuffer的指针地址。 |
| 返回值说明 | size：int，aclDataBuffer类型中数据的内存大小。 |
| 约束说明 | 无 |
父主题： 公共接口
函数：update_data_buffer
| C函数原型 | aclError aclUpdateDataBuffer(aclDataBuffer *dataBuffer, void *data, size_t size) |
|---|---|
| Python函数 | ret = acl.update_data_buffer(data_buffer, data, size) |
| 函数功能 | 更新aclDataBuffer中数据的内存及大小。同步接口。 更新aclDataBuffer后，之前aclDataBuffer中存放数据的内存如果不使用，需及时释放，否则可能会导致内存泄漏。 |
| 输入说明 | data_buffer：int，aclDataBuffer类型的指针地址。 需提前调用acl.create_data_buffer接口创建aclDataBuffer类型的数据。 该内存需由用户自行管理，调用acl.rt.malloc接口/acl.rt.free接口申请/释放内存，或调用acl.rt.malloc_host接口/acl.rt.free_host接口申请/释放内存。 data：int，存放数据内存地址的指针地址。 size：int，内存大小，单位Byte。如果用户需要使用空Tensor，则在申请内存时，内存大小最小为1Byte。 |
| 返回值说明 | ret：int，错误码。 - 返回0表示成功。 - 返回其它值表示失败。 |
| 约束说明 | 无 |
父主题： 公共接口
在线提单