op_ima_obj_attr_set_str()
摘要
为指定对象中的字符串属性赋值。
语法
op_ima_obj_attr_set_str (objid, attr_name, value)
| 参数 | 类型 | 说明 |
|---|---|---|
objid |
Objid |
目标对象的对象 ID [对象 ID 可通过 Topo 包和 Id 包中的多个内核过程获得: op_id_self()、op_topo_parent()、op_topo_child()、op_id_from_userid() 和 op_id_from_name()。] |
attr_name |
const char * |
目标属性的名称 [该值必须是指定对象的已定义属性。] |
value |
const char * |
指定属性的新值 |
返回类型
Compcode
若属性值设置成功,返回 OPC_COMPCODE_SUCCESS;否则返回 OPC_COMPCODE_FAILURE。
示例
/* Extract the interface’s address and subnetwork mask. */
op_ima_obj_attr_get_str (addr_info_attr_objid, "Address", IPC_ADDR_STR_LEN,
address_string);
op_ima_obj_attr_get_str (addr_info_attr_objid, "Subnet Mask", IPC_ADDR_STR_LEN,
subnet_mask_string);
/* Check the values of addresses. If the value is left empty, assign AUTO_ADDRESS */
/* to it. A valid address is at least 7 characters, such as 0.0.0.0. */
if (strlen (address_string) < 7)
{
op_ima_obj_attr_set_str (addr_info_attr_objid, "Address", IPC_AUTO_ADDRESS);
strcpy (address_string, IPC_AUTO_ADDRESS);
}
if (strlen (subnet_mask_string) < 7)
{
op_ima_obj_attr_set_str (addr_info_attr_objid, "Subnet Mask", IPC_AUTO_ADDRESS);
strcpy (subnet_mask_string, IPC_AUTO_ADDRESS);
}
详情
如果找不到该属性,此内核过程不会报告错误;你必须检查返回值才能发现这一点。由于不报告错误,此内核过程免除了事先使用 op_ima_obj_attr_exists() 以防止产生警告的需要。
用途
提供一种在仿真进行过程中动态赋值对象属性的机制。此内核过程的工作方式与 op_ima_obj_attr_set() 完全相同,但仅适用于数据类型为 string 的对象属性。完整的用途与详情参见 op_ima_obj_attr_set()。
错误
- 与 op_ima_obj_attr_set() 相同。
参考
- 使用内核过程 op_ima_obj_attr_set_dbl() 设置类型为 double 的对象属性的值
- 使用内核过程 op_ima_obj_attr_set_int32() 设置类型为 integer 的对象属性的值
- 使用内核过程 op_ima_obj_attr_set_objid() 设置类型为 objid 的对象属性的值
- 使用内核过程 op_ima_obj_attr_set_toggle() 设置类型为 toggle 的对象属性的值
- 使用内核过程 op_ima_obj_attr_get()、op_ima_obj_attr_get_dbl()、op_ima_obj_attr_get_int32()、op_ima_obj_attr_get_objid()、op_ima_obj_attr_get_str() 和 op_ima_obj_attr_get_toggle() 获取对象属性的值
- 使用内核过程 op_ima_sim_attr_get()、op_ima_sim_attr_get_dbl()、op_ima_sim_attr_get_int32() 和 op_ima_sim_attr_get_str() 获取仿真属性的值
- 使用内核过程 op_ima_obj_svar_get() 获取进程状态变量的值
- 使用内核过程 op_ima_obj_command() 向对象发出命令
- 使用内核过程 op_id_self() 获取所在处理器或队列的对象 ID
- 使用内核过程 op_id_from_name() 获取任意对象的对象 ID