## named\_value\_t ### 概述 命名的值。 ---------------------------------- ### 函数

| 函数名称 | 说明 | | -------- | ------------ | | named\_value\_cast | | | named\_value\_create | | | named\_value\_deinit | | | named\_value\_destroy | | | named\_value\_get\_value | | | named\_value\_init | | | named\_value\_set\_name | | | named\_value\_set\_value | | ### 属性

| 属性名称 | 类型 | 说明 | | -------- | ----- | ------------ | | name | char* | 名称。 | | value | value\_t | 值。 | #### named\_value\_cast 函数 ----------------------- * 函数功能: >

转换为named_value对象(供脚本语言使用)。 * 函数原型: ``` named_value_t* named_value_cast (named_value_t* nv); ``` * 参数说明: | 参数 | 类型 | 说明 | | -------- | ----- | --------- | | 返回值 | named\_value\_t* | 返回named\_value对象。 | | nv | named\_value\_t* | named\_value对象。 | #### named\_value\_create 函数 ----------------------- * 函数功能: >

创建named_value对象。 * 函数原型: ``` named_value_t* named_value_create (); ``` * 参数说明: | 参数 | 类型 | 说明 | | -------- | ----- | --------- | | 返回值 | named\_value\_t* | 返回named\_value对象。 | #### named\_value\_deinit 函数 ----------------------- * 函数功能: >

重置named_value对象。 * 函数原型: ``` ret_t named_value_deinit (named_value_t* nv); ``` * 参数说明: | 参数 | 类型 | 说明 | | -------- | ----- | --------- | | 返回值 | ret\_t | 返回RET\_OK表示成功,否则表示失败。 | | nv | named\_value\_t* | named\_value对象。 | #### named\_value\_destroy 函数 ----------------------- * 函数功能: >

销毁named_value对象。 * 函数原型: ``` ret_t named_value_destroy (named_value_t* nv); ``` * 参数说明: | 参数 | 类型 | 说明 | | -------- | ----- | --------- | | 返回值 | ret\_t | 返回RET\_OK表示成功,否则表示失败。 | | nv | named\_value\_t* | named\_value对象。 | #### named\_value\_get\_value 函数 ----------------------- * 函数功能: >

获取值对象(主要给脚本语言使用)。 * 函数原型: ``` value_t* named_value_get_value (named_value_t* nv); ``` * 参数说明: | 参数 | 类型 | 说明 | | -------- | ----- | --------- | | 返回值 | value\_t* | 返回值对象。 | | nv | named\_value\_t* | named\_value对象。 | #### named\_value\_init 函数 ----------------------- * 函数功能: >

初始化。 * 函数原型: ``` ret_t named_value_init (named_value_t* nv, const char* name, const value_t* value); ``` * 参数说明: | 参数 | 类型 | 说明 | | -------- | ----- | --------- | | 返回值 | ret\_t | 返回named\_value对象。 | | nv | named\_value\_t* | named\_value对象。 | | name | const char* | 名称。 | | value | const value\_t* | 值。 | #### named\_value\_set\_name 函数 ----------------------- * 函数功能: >

设置名称。 * 函数原型: ``` ret_t named_value_set_name (named_value_t* nv, const char* name); ``` * 参数说明: | 参数 | 类型 | 说明 | | -------- | ----- | --------- | | 返回值 | ret\_t | 返回RET\_OK表示成功,否则表示失败。 | | nv | named\_value\_t* | named\_value对象。 | | name | const char* | 名称。 | #### named\_value\_set\_value 函数 ----------------------- * 函数功能: >

设置值。 * 函数原型: ``` ret_t named_value_set_value (named_value_t* nv, const value_t* value); ``` * 参数说明: | 参数 | 类型 | 说明 | | -------- | ----- | --------- | | 返回值 | ret\_t | 返回RET\_OK表示成功,否则表示失败。 | | nv | named\_value\_t* | named\_value对象。 | | value | const value\_t* | 值。 | #### name 属性 ----------------------- >

名称。 * 类型:char* | 特性 | 是否支持 | | -------- | ----- | | 可直接读取 | 是 | | 可直接修改 | 否 | | 可脚本化 | 是 | #### value 属性 ----------------------- >

值。 * 类型:value\_t | 特性 | 是否支持 | | -------- | ----- | | 可直接读取 | 是 | | 可直接修改 | 否 |