op_topo_object_count()
摘要
获取指定元类型的对象数量。
语法
op_topo_object_count (objmtype)
| 参数 | 类型 | 说明 |
|---|---|---|
objmtype |
int |
对象元类型 [该值是一个整数代码,指定所关注对象的对象类型(参见表 69“对象类型符号常量”第 19 页)。] |
返回类型
int
指定类型的对象数量。
若发生可恢复错误,将返回符号常量 OPC_INT_INVALID 所代表的特殊值。
示例
摘自:示例模型(models/std/sdr);进程模型 (sdr_addr);状态 (INIT);enter execs。
/* Get the number of nodes. */
num_nodes = op_topo_object_count (OPC_OBJTYPE_NODE_FIX);
/* Set up the address distribution. */
address_dist = op_dist_load (“uniform_int”, 0, num_nodes - 1);
/* Initialize the ICI used for address announcement. */
ici_ptr = op_ici_create (“sdr_addr”);
详情
无。
用途
提供了一种获取给定类型对象数量的方法,无论这些对象在对象层次结构中的位置如何。当进程需要获取或设置属于某一类型对象的属性时,这很有用。例如,进程可能需要在仿真开始时将所有总线链路的误码率设置为 0.0。内核过程 op_topo_object_count() 将为循环提供上界,该循环调用 op_topo_object() 获取每条总线链路的对象 ID,然后调用 op_ima_obj_attr_set() 设置误码率属性值。
错误
- 可恢复错误:对象元类型 (<objmtype>) 无法识别。
参考
- 使用内核过程 op_topo_object() 获取对象的对象 ID
- 使用内核过程 op_topo_assoc_count() 确定输入或输出关联的数量
- 使用内核过程 op_topo_child_count() 确定对象的子对象数量