函数：free

产品支持情况

产品	是否支持
Atlas A3 训练系列产品 / Atlas A3 推理系列产品	√
Atlas A2 训练系列产品 / Atlas 800I A2 推理产品 /A200I A2 Box 异构组件	√
Atlas 训练系列产品	√
Atlas 推理系列产品	√
Atlas 200I/500 A2 推理产品	√
Atlas 200/300/500 推理产品	√

功能说明

释放Device上的内存。

函数原型

C函数原型
1

aclError aclrtFree(void *devPtr)
python函数
1

ret= acl.rt.free(dev_ptr)

参数说明

参数名	说明
dev_ptr	int，待释放内存的指针地址。

返回值说明

返回值	说明
ret	int，错误码，返回0表示成功，返回其它值表示失败。

约束说明

acl.rt.free接口只能释放通过acl.rt.malloc接口或acl.rt.malloc_cached接口。
本接口会立刻释放传入的内存，函数内部不会进行隐式的Device同步或流同步。用户需要确保调用完本接口后不再对该内存指针进行访问。

资源参考

接口调用示例，参见数据传输。

父主题： 内存管理