awtk/docs/manual/conf_obj_t.md

117 lines
3.0 KiB
Markdown
Raw Normal View History

2020-06-07 10:21:09 +08:00
## conf\_obj\_t
### 概述
![image](images/conf_obj_t_0.png)
conf对象。
----------------------------------
### 函数
<p id="conf_obj_t_methods">
| 函数名称 | 说明 |
| -------- | ------------ |
| <a href="#conf_obj_t_conf_obj_create">conf\_obj\_create</a> | |
2022-12-05 12:10:53 +08:00
| <a href="#conf_obj_t_conf_obj_create_sub_object">conf\_obj\_create\_sub\_object</a> | 根据路径创建一个子对象。 |
2020-06-07 10:21:09 +08:00
| <a href="#conf_obj_t_conf_obj_get_doc">conf\_obj\_get\_doc</a> | 获取doc对象用于更高级的操作。 |
| <a href="#conf_obj_t_conf_obj_save">conf\_obj\_save</a> | 保存文档。 |
2020-06-21 08:55:55 +08:00
| <a href="#conf_obj_t_conf_obj_set_readonly">conf\_obj\_set\_readonly</a> | 设置为只读模式。 |
2020-06-07 10:21:09 +08:00
#### conf\_obj\_create 函数
-----------------------
* 函数功能:
> <p id="conf_obj_t_conf_obj_create">
* 函数原型:
```
2022-12-05 12:10:53 +08:00
tk_object_t* conf_obj_create (conf_doc_save_t save, conf_doc_load_t load, const char* url, bool_t create_if_not_exist);
2020-06-07 10:21:09 +08:00
```
* 参数说明:
| 参数 | 类型 | 说明 |
| -------- | ----- | --------- |
2022-12-05 12:10:53 +08:00
| 返回值 | tk\_object\_t* | 返回配置对象。 |
2020-06-07 10:21:09 +08:00
| save | conf\_doc\_save\_t | 保存函数。 |
| load | conf\_doc\_load\_t | 加载函数。 |
| url | const char* | 路径。 |
| create\_if\_not\_exist | bool\_t | 如果不存在是否创建。 |
2022-12-05 12:10:53 +08:00
#### conf\_obj\_create\_sub\_object 函数
-----------------------
* 函数功能:
> <p id="conf_obj_t_conf_obj_create_sub_object">根据路径创建一个子对象。
* 函数原型:
```
tk_object_t* conf_obj_create_sub_object (tk_object_t* conf, const char* path);
```
* 参数说明:
| 参数 | 类型 | 说明 |
| -------- | ----- | --------- |
| 返回值 | tk\_object\_t* | 返回配置对象。 |
| conf | tk\_object\_t* | 配置对象。 |
| path | const char* | 路径。 |
2020-06-07 10:21:09 +08:00
#### conf\_obj\_get\_doc 函数
-----------------------
* 函数功能:
> <p id="conf_obj_t_conf_obj_get_doc">获取doc对象用于更高级的操作。
* 函数原型:
```
2022-12-05 12:10:53 +08:00
conf_doc_t* conf_obj_get_doc (tk_object_t* conf);
2020-06-07 10:21:09 +08:00
```
* 参数说明:
| 参数 | 类型 | 说明 |
| -------- | ----- | --------- |
2022-12-05 12:10:53 +08:00
| 返回值 | conf\_doc\_t* | 返回doc对象。 |
| conf | tk\_object\_t* | conf对象。 |
2020-06-07 10:21:09 +08:00
#### conf\_obj\_save 函数
-----------------------
* 函数功能:
> <p id="conf_obj_t_conf_obj_save">保存文档。
* 函数原型:
```
2022-12-05 12:10:53 +08:00
ret_t conf_obj_save (tk_object_t* conf);
2020-06-07 10:21:09 +08:00
```
* 参数说明:
| 参数 | 类型 | 说明 |
| -------- | ----- | --------- |
| 返回值 | ret\_t | 返回RET\_OK表示成功否则表示失败 |
2022-12-05 12:10:53 +08:00
| conf | tk\_object\_t* | conf对象。 |
2020-06-21 08:55:55 +08:00
#### conf\_obj\_set\_readonly 函数
-----------------------
* 函数功能:
> <p id="conf_obj_t_conf_obj_set_readonly">设置为只读模式。
* 函数原型:
```
2022-12-05 12:10:53 +08:00
ret_t conf_obj_set_readonly (tk_object_t* conf, bool_t readonly);
2020-06-21 08:55:55 +08:00
```
* 参数说明:
| 参数 | 类型 | 说明 |
| -------- | ----- | --------- |
| 返回值 | ret\_t | 返回RET\_OK表示成功否则表示失败 |
2022-12-05 12:10:53 +08:00
| conf | tk\_object\_t* | conf对象。 |
2020-06-21 08:55:55 +08:00
| readonly | bool\_t | 只读模式。 |