awtk/docs/manual/object_array_t.md

object_array_t

概述

简单的动态数组，内部存放value对象。

访问时属性名称为：

• "size"/"length" 用于获取数组的长度。
• index 用于访问属性，-1可以用来追加新元素。

---

函数

函数名称	说明
object_array_clear_props	清除全部属性。
object_array_clone	克隆对象。
object_array_create	创建对象。
object_array_unref	for script gc

属性

属性名称	类型	说明
props	value_t	属性数组。
props_capacity	uint32_t	属性数组的容量。
props_size	uint32_t	属性个数。

object_array_clear_props 函数

---

• 函数功能：

清除全部属性。

• 函数原型：

ret_t object_array_clear_props (object_t* obj);

• 参数说明：

参数	类型	说明
返回值	ret_t	返回RET_OK表示成功，否则表示失败。
obj	object_t*	对象。

object_array_clone 函数

---

• 函数功能：

克隆对象。

• 函数原型：

object_t* object_array_clone (object_array_t* o);

• 参数说明：

参数	类型	说明
返回值	object_t*	返回object对象。
o	object_array_t*	被克隆的对象。

object_array_create 函数

---

• 函数功能：

创建对象。

• 函数原型：

object_t* object_array_create ();

• 参数说明：

参数	类型	说明
返回值	object_t*	返回object对象。

object_array_unref 函数

---

• 函数功能：

for script gc

• 函数原型：

ret_t object_array_unref (object_t* obj);

• 参数说明：

参数	类型	说明
返回值	ret_t	返回RET_OK表示成功，否则表示失败。
obj	object_t*	对象。

props 属性

---

属性数组。

• 类型：value_t

特性	是否支持
可直接读取	是
可直接修改	否

props_capacity 属性

---

属性数组的容量。

• 类型：uint32_t

特性	是否支持
可直接读取	是
可直接修改	否

props_size 属性

---

属性个数。

• 类型：uint32_t

特性	是否支持
可直接读取	是
可直接修改	否
可脚本化	是