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>)指向受限对象。
参考
- 使用内核过程 op_ima_obj_attr_get()、op_ima_obj_attr_get_color()、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_color()、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