op_ima_sim_attr_get_str()
摘要
获取 string 类型仿真属性的值。
语法
op_ima_sim_attr_get_str (attr_name, buffer_size, value_buffer)
| 参数 | 类型 | 说明 |
|---|---|---|
attr_name |
const char * |
目标属性的名称 [该值必须指定仿真环境中已定义的属性,否则会弹出针对该属性值的输入提示。] |
buffer_size |
unsigned int |
value_buffer 的大小(包含结尾 '\0' 所占的空间) |
value_buffer |
char * |
指向某个变量的指针,该变量将被填入指定属性的值(值的最大长度为 buffer_size – 1 个字符) |
返回类型
Compcode
若成功获取属性值,返回 OPC_COMPCODE_SUCCESS;否则返回 OPC_COMPCODE_FAILURE。
示例
/* Obtain the value of the simulation attribute "IP */
/* Interface Addressing Mode", if specified. */
if (op_ima_sim_attr_exists ("IP Interface Addressing Mode") == OPC_TRUE)
{
/* The simulation attribute has been specified a value. */
op_ima_sim_attr_get_str ("IP Interface Addressing Mode", 32,
ip_iface_addr_mode_setting);
}
详情
无。
用途
提供一种机制,用于获取在仿真运行时已被赋值的仿真属性。该内核过程与 op_ima_sim_attr_get() 的工作方式完全相同,但仅适用于数据类型为 string 的仿真属性。完整用途与详情参见 op_ima_sim_attr_get()。
错误
- 与 op_ima_sim_attr_get() 相同。
参考
- 使用内核过程 op_ima_sim_attr_get_str_sized() 通过带长度的缓冲区获取 string 类型仿真属性的值
- 使用内核过程 op_ima_sim_attr_get_dbl() 获取 double 类型仿真属性的值
- 使用内核过程 op_ima_sim_attr_get_int32() 获取 integer 类型仿真属性的值
- 使用内核过程 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_obj_attr_set()、op_ima_obj_attr_set_dbl()、op_ima_obj_attr_set_int32()、op_ima_obj_attr_set_objid()、op_ima_obj_attr_set_str() 和 op_ima_obj_attr_set_toggle() 为对象属性赋值
- 使用内核过程 op_ima_obj_svar_get() 获取进程状态变量的值
- 使用内核过程 op_ima_obj_command() 向对象发出命令