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>) 指向受限对象。

参考

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