packages/third-party/awtk-ui/awtk/docs/fscript_object.md

## object 扩展函数

object 适用于 app\_conf、typed\_array 和 array 等各种对象。

### 1. object\_create

> 创建缺省的 object 对象，可以当一个 map 使用。
----------------------------

#### 原型

```js
object_create() => object
```

#### 示例

```js
var a = object_create()
```

### 2. object\_get

> 获取对象的属性。
----------------------------

可以通过 value\_is\_valid 来判断返回值是否有效。

#### 原型

```js
object_get(o, key) => value
object_get(o, key, defval) => value
```

也可以直接访问对象的属性：

```js
print(o.key)
```

#### 示例

```js
print(object_get(a, "age"))
print(a.age)
```

### 3. object\_set

> 设置对象的属性。
----------------------------

#### 原型

```js
object_set(obj, key, value) => bool
```

#### 示例

```js
object_set(a, "age", 123);
```

### 4. object\_remove

> 删除对象的属性。 
----------------------------

#### 原型

```js
object_remove(obj, key) => bool
```

#### 示例

```js
object_remove(a, "age")
```

### 5. object\_ref

> 引用计数加1。 
----------------------------

#### 原型

```js
object_ref(obj) => object
```

#### 示例

```js
object_ref(a)
```

### 5. object\_unref

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

#### 原型

```js
object_unref(obj)
```

#### 示例

```js
object_ref(a)
```

### 6. object\_forward\_events

> 将源对象的事件转发目标对象。 
----------------------------

目前支持以下事件的转发：

* EVT_PROP_CHANGED：对象中的属性改变事件。
* EVT_PROPS_CHANGED：对象中的属性改变事件。
* EVT_ITEMS_CHANGED：集合对象中的项目改变事件

#### 原型

```js
object_forward_events(src_obj, dst_obj)
```

#### 示例

```js
global = object_create()
global.arr = array_create()
object_forward_events(global.arr, global)
```

### 完整示例

```js
var a = object_create()
assert(!value_is_null(a))
assert(object_set(a, "age", 123))
assert(a.age ==  123)

assert(object_set(a, "name", "awtk"))
assert(a.name == "awtk")

assert(object_get(a, "age") == 123)
print(object_get(a, "age"))
assert(object_remove(a, "age"))
assert(!value_is_valid(object_get(a, "age")))
unset(a)

var person = object_create()
assert(!value_is_null(person))

assert(object_set(person, "age", 123))
assert(person.age ==  123)

assert(object_set(person, "name", "awtk"))
assert(person.name == "awtk")

var g = object_create()
g.arr = array_create()
object_forward_events(g.arr, g)
```