awtk/docs/manual/object_t.md

object_t

概述

对象接口。

函数

函数名称	说明
object_compare	比较两个对象。
object_create	创建对象。
object_foreach_prop	遍历所有属性。
object_get_prop	获取指定属性的值。
object_ref	引用计数加1。
object_remove_prop	删除指定属性。
object_set_name	设置对象的名称。
object_set_prop	设置指定属性的值。
object_unref	引用计数减1。引用计数为0时，销毁对象。

属性

名属性称	类型	说明
name	char*	对象的名称。
ref_count	int32_t	引用计数。

object_compare 函数

---

• 函数功能：

比较两个对象。

• 函数原型：

int32_t object_compare (object_t* obj, object_t* other);

• 参数说明：

参数	类型	说明
返回值	int32_t	返回比较结果。
obj	object_t*	object对象。
other	object_t*	比较的object对象。

object_create 函数

---

• 函数功能：

创建对象。

仅供子类调用。

• 函数原型：

ret_t object_create (const object_vtable_t* vt);

• 参数说明：

参数	类型	说明
返回值	ret_t	返回object对象。
vt	const object_vtable_t*	虚函数表。

object_foreach_prop 函数

---

• 函数功能：

遍历所有属性。

• 函数原型：

ret_t object_foreach_prop (object_t* obj, tk_visit_t on_prop, void* ctx);

• 参数说明：

参数	类型	说明
返回值	ret_t	返回RET_OK表示成功，否则表示失败。
obj	object_t*	object对象。
on_prop	tk_visit_t	回调函数。
ctx	void*	回调函数上下文。

object_get_prop 函数

---

• 函数功能：

获取指定属性的值。

• 函数原型：

ret_t object_get_prop (object_t* obj, const char* name, value_t* v);

• 参数说明：

参数	类型	说明
返回值	ret_t	返回RET_OK表示成功，否则表示失败。
obj	object_t*	object对象。
name	const char*	属性的名称。
v	value_t*	返回属性的值。

object_ref 函数

---

• 函数功能：

引用计数加1。

• 函数原型：

object_t* object_ref (object_t* obj);

• 参数说明：

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

object_remove_prop 函数

---

• 函数功能：

删除指定属性。

• 函数原型：

ret_t object_remove_prop (object_t* obj, const char* name);

• 参数说明：

参数	类型	说明
返回值	ret_t	返回RET_OK表示成功，否则表示失败。
obj	object_t*	object对象。
name	const char*	属性的名称。

object_set_name 函数

---

• 函数功能：

设置对象的名称。

• 函数原型：

ret_t object_set_name (object_t* obj, const char* name);

• 参数说明：

参数	类型	说明
返回值	ret_t	返回RET_OK表示成功，否则表示失败。
obj	object_t*	object对象。
name	const char*	对象的名称。

object_set_prop 函数

---

• 函数功能：

设置指定属性的值。

• 函数原型：

ret_t object_set_prop (object_t* obj, const char* name, value_t* v);

• 参数说明：

参数	类型	说明
返回值	ret_t	返回RET_OK表示成功，否则表示失败。
obj	object_t*	object对象。
name	const char*	属性的名称。
v	value_t*	属性的值。

object_unref 函数

---

• 函数功能：

引用计数减1。引用计数为0时，销毁对象。

• 函数原型：

ret_t object_unref (object_t* obj);

• 参数说明：

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

name 属性

---

对象的名称。

• 类型：char*

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

ref_count 属性

---

引用计数。

• 类型：int32_t

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