1.4 gc – 内存管理 API手册#

该模块实现了相应CPython模块的子集,如下所述。有关更多信息,请参阅原始CPython文档:gc.

K230新增了sys_heapsys_pagesys_mmz接口来获取RT-Smart系统的内存信息

  • sys_heap: 内核应用使用

  • sys_page: 用户应用使用

  • sys_mmz: 多媒体驱动使用,Sensor,Display等模块

1. 函数#

1.1 enable#

gc.enable()

启用自动垃圾回收。

1.2 disable#

gc.disable()

禁用自动垃圾回收。仍然可以分配堆内存,仍然可以使用 gc.collect() 手动启动垃圾收集。

1.3 collect#

gc.collect()

运行垃圾回收。

1.4 mem_alloc#

gc.mem_alloc()

返回分配的堆 RAM 的字节数。

与CPython的区别

此功能是 MicroPython 扩展。

1.5 mem_free#

gc.mem_free()

返回可用堆RAM的字节数,如果堆剩余数量未知,则返回-1。

与CPython的区别

此功能是 MicroPython 扩展。

1.6 threshold#

gc.threshold([amount])

设置或查询其他GC分配阈值。通常,仅当不能满足新分配时,即在内存不足(OOM)条件下才触发集合。如果调用此函数,除了OOM之外,每次分配了大量字节后都会触发一个集合(总共,因为上一次分配了这么多的字节)。 amount通常被指定为小于完整堆大小,意图在堆耗尽之前触发集合,并希望早期集合可以防止过多的内存碎片。这是一种启发式度量,其效果因应用程序而异,以及量参数的最佳值。

不带参数调用函数将返回阈值的当前值。值-1表示禁用的分配阈值。

与CPython的区别

此函数是MicroPython扩展。 CPython有一个类似的函数 - set_threshold(),但是由于不同的GC实现,它的签名和语义是不同的。

1.7 sys_heap#

gc.sys_heap()

查询系统heap内存使用情况,返回大小为3的元组,分别为totalfreeused,单位为Byte

1.8 sys_page#

gc.sys_page()

查询系统page内存使用情况,返回大小为3的元组,分别为totalfreeused,单位为Byte

1.8 sys_mmz#

gc.sys_mmz()

查询系统mmz内存使用情况,返回大小为3的元组,分别为totalfreeused,单位为Byte