op_topo_child_count()
摘要
获取指定父对象内包含的所请求类型的子对象数量。
语法
op_topo_child_count (parent_objid, child_type)
| 参数 | 类型 | 说明 |
|---|---|---|
parent_objid |
Objid |
父对象的对象 ID [对象 ID 可通过 Id 包中的多个内核过程获得: op_id_self()、op_id_from_userid() 和 op_id_from_name()。此外,对象 ID 也可从 Topo 包内核过程 op_topo_parent()、op_topo_child()、op_topo_assoc() 和 op_topo_connect() 的先前调用中获得。] |
child_type |
int |
所关注子对象的类型 [该值是一个整数代码,指定所关注子对象的对象类型(参见表 69“对象类型符号常量”第 19 页)。] |
返回类型
int
父对象内包含的指定类型的子对象数量。如果父对象不支持所请求类型的子对象,或父对象 ID 无效,将返回符号常量 OPC_INT_INVALID 所代表的特殊值。
示例
/* determine the type of the interrupt */
if (op_intrpt_type () == OPC_INTRPT_REMOTE)
{
/* cold reboot: total loss of queued packets */
if (op_intrpt_code () == COLD_REBOOT)
{
/* record the number of packets lost */
num_lost_packets += op_q_stat (OPC_QSTAT_PKSIZE);
/* flush the queue of its contents */
op_q_flush ();
}
/* prioritize: loop through and sort all subqueues */
else if (op_intrpt_code () == PRIORITIZE)
{
op_ima_obj_attr_get (op_id_self(), "subqueue", &subq_objid);
num_subqs = op_topo_child_count (subq_objid, OPC_OBJTYPE_SUBQ);
for (i = 0; i < num_subqs; i++)
op_subq_sort (i);
}
}
详情
通常包含子对象的仿真对象有:
- 子网:子对象为子网、节点、链路和抽头
- 节点:子对象为模块、数据包流和统计量连线
- 队列:子对象为子队列复合属性
- 接收机:子对象为接收机信道复合属性对象
- 发射机:子对象为发射机信道复合属性对象
- 复合属性:子对象为通用子对象、子队列、接收机信道和发射机信道
通常不包含子对象的仿真对象有:
- 单工和双工点对点链路
- 总线链路
- 总线链路抽头
- 处理器
- 天线
路径没有子对象,也不属于任何子网。因此,如果 parent_object 引用路径对象,或 child_type 等于 OPC_OBJTYPE_PATH,该函数返回零。
上述对象包含子对象的情形包括:用户为对象定义了扩展复合属性,以及用户为处理器、链路或抽头添加了模型属性。
用途
提供了一种确定父对象内包含的子对象数量的机制,这对于为将对每个子对象执行某些操作的循环设定边界非常有用。若要获取父对象内每个子对象的对象 ID,可以使用父对象 ID、定义对象类型的同一符号常量以及循环索引调用内核过程 op_topo_child()。
错误
- 可恢复错误:对象 ID (<parent_objid>) 超出范围。
- 可恢复错误:对象元类型 (<child_type>) 无法识别。
- 可恢复错误:对象 ID (<parent_objid>) 指向受限对象。
参考
- 使用内核过程 op_topo_child() 根据索引获取子对象的对象 ID
- 使用内核过程 op_topo_object_count() 确定特定类型的对象数量
- 使用内核过程 op_topo_assoc_count() 获取输入或输出关联的数量