op_ima_sim_attr_get_str_sized()

摘要

使用带长度的缓冲区获取 string 类型仿真属性的值。

语法

op_ima_sim_attr_get_str_sized (attr_name, size_ptr, value_buffer)
参数 类型 说明
attr_name const char * 目标属性的名称
[该值必须指定仿真环境中已定义的属性,否则会弹出针对该属性值的输入提示。]
size_ptr size_t * 调用时,指向 value_buffer 大小的指针(包含结尾 '\0' 所占的空间)。
返回时,value_buffer 中属性值的实际大小。
value_buffer char * 指向某个变量的指针,该变量将被填入指定属性的值(值的最大长度为 size_ptr – 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_sized ("IP Interface Addressing Mode", 32,
		ip_iface_addr_mode_setting);
	}

详情

此函数与 op_ima_sim_attr_get_str() 类似,区别在于它带有一个大小参数,并且在返回属性值时不会溢出 value_buffer。对于大于 value_buffer 的 string 属性值,将返回截断后的字符串。

用途

提供一种机制,用于获取在仿真运行时已被赋值的仿真属性。该内核过程与 op_ima_sim_attr_get() 的工作方式完全相同,但仅适用于数据类型为 string 的仿真属性。完整用途与详情参见 op_ima_sim_attr_get()。

错误

参考

本站文档由 北京智网畅联科技有限公司 整理、翻译并提供 · Documentation compiled and provided by Beijing ZNetLink Technology Co., Ltd.

交流群 · QQ Group:OPNET/智网妙算网络仿真交流群(群号 486383494)

原文档 © 2017 Riverbed Technology · 本站为公益翻译,由 AI 辅助完成,请仔细甄别

Original documentation © 2017 Riverbed Technology. Community translation, AI-assisted. Contact: jiazequn@znetlink.com