op_topo_object()
摘要
获取由类型和索引指定的对象的对象 ID。
语法
op_topo_object (objmtype, index)
| 参数 | 类型 | 说明 |
|---|---|---|
objmtype |
int |
对象类型 [该值是一个整数代码,指定所关注对象的对象类型(参见表 69“对象类型符号常量”第 19 页)。] |
index |
int |
对象的数字索引 [对象索引从 0 开始,每次递增 1,最大值为该类型对象数量减 1。] |
返回类型
Objid
指定对象的对象 ID。若发生可恢复错误,将返回符号常量 OPC_OBJID_INVALID 所代表的特殊值。
示例
/* Loop through the bus transmitter channels and abort all transmissions. */
/* Obtain the number of bus transmitter channels in the model. */
txch_count = op_topo_object_count (OPC_OBJTYPE_BUTXCH);
/* Loop through the channels and abort the transmission. */
for (i = 0; i < txch_count; i++)
{
ch_id = op_topo_object (OPC_OBJTYPE_BUTXCH, i);
op_ima_obj_command (ch_id, “abort”);
}
详情
无。
用途
提供了一种基于对象类型获取对象对象 ID 的机制,无论该对象在对象层次结构中的位置如何。当进程需要获取或设置属于某一类型对象的属性时,这很有用。例如,进程可能需要在仿真开始时将所有总线链路的误码率设置为 0.0。内核过程 op_topo_object_count() 将为循环提供上界,该循环调用 op_topo_object() 获取每条总线链路的对象 ID,随后调用 op_ima_obj_attr_set() 设置误码率属性值。
错误
- 可恢复错误:对象元类型 (<objmtype>) 无法识别。
- 可恢复错误:对象索引 (<index>) 超出范围。
参考
- 使用内核过程 op_topo_object_count() 确定特定类型对象的数量
- 使用内核过程 op_ima_obj_attr_get() 获取对象属性的值
- 使用内核过程 op_ima_obj_attr_set() 为对象属性赋值