op_ima_obj_attr_set()

摘要

为指定对象中的属性赋值。

语法

op_ima_obj_attr_set (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 void* 指定属性的新值
[该参数可接受整数、double、PrgT_Color 或字符串值。此参数的数据类型必须与 attr_name 所引用属性的数据类型一致,否则属性可能被赋予错误的值。
如果属性的类型为 profile,新值必须是包含访问该 profile 所需信息的 profile 规范。该规范通过函数 prg_profile_spec_get() 获得。]

返回类型

Compcode

若属性值设置成功,返回 OPC_COMPCODE_SUCCESS;否则返回 OPC_COMPCODE_FAILURE。

示例

摘自:示例模型(models/std/jammers);进程模型(jam_sweep_proc);状态(TX_ON);enter execs。

/* begin a new transmission */
double	    freq_tx;
/* compute the frequency of transmission */
freq_tx = freq_base + freq_slot * freq_interval;
/* advance the frequency slot for next transmission */
freq_slot = (freq_slot + 1) % num_intervals;
/* assign the selected frequency to the transmitter channel */
op_ima_obj_attr_set (txch_objid, "min frequency", freq_tx);

详情

对象属性值可以赋予网络域对象(子网、节点和链路)、节点域对象(模块)以及复合属性,前提是这些属性此前已通过 Network、Node、Process 或 Link 编辑器(或通过 Ema 程序)定义过。此外,值也可以赋予那些已被提升(promote)到层次上包含定义对象的对象中的属性(例如,从处理器的根进程自动提升的属性,可以通过层次上包含该处理器的子网进行赋值)。引用被提升的属性时,需要为每一个层次中间对象在属性名前添加以点分隔的前缀;也就是说,属性名称按其在被引用对象菜单中显示的形式给出。例如,在节点层为进程属性赋值时,属性名前须加上“包含”该进程实例的模块名称。无论使用哪一层建模级别引用属性,找到并赋值的都是同一个公共属性存储单元。

并非所有对象属性都可以在仿真期间通过调用 op_ima_obj_attr_set() 访问。第 3 章“Network Reference”第 60 页详细介绍了链路和节点属性。任何 Simulation/Access 字段标记为 N/A 的属性,都不能通过调用 op_ima_obj_attr_set() 访问。

用途

提供一种在仿真进行过程中动态赋值对象属性的机制。此功能可供处理器(或队列)用于控制其他模块。此内核过程与 op_ima_obj_attr_get() 配合使用,还可以提供一种不涉及 Packet、ICI 或中断传递的远程进程间通信方法;在这种应用中应注意,远程修改另一对象属性的值不会引发中断,因此只有当被修改的对象下次通过内核过程 op_ima_obj_attr_get() 查询其属性值时才会生效。

此内核过程存在针对特定数据类型的版本。这些替代内核过程比这种可变参数版本更高效,并且能让编译器捕获此内核过程漏掉的参数错误。详情参见 op_ima_obj_attr_set_color()、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()。

错误

  • 程序中止:Segmentation violation。(由于无效的值指针、attr_name 的地址无效,或值的类型不正确)
  • 可恢复错误:属性名称(<attr_name>)对对象(<objid>)而言不可识别。
  • 可恢复错误:对象 ID(<objid>)超出范围。
  • 可恢复错误:对象(<objid>)的属性(<attr_name>)为只读。
  • 可恢复错误:值对属性(<attr_name>)无效。
  • 可恢复错误:对象 ID(<objid>)指向受限对象。

参考

本站文档由 北京智网畅联科技有限公司 整理、翻译并提供 · 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