op_strm_empty()

摘要

判定指定输入流中是否没有数据包。

语法

op_strm_empty (instrm_index)
参数 类型 说明
instrm_index int 目标输入流的数字索引 [输入流索引从 0 开始,依次递增 1。]

返回类型

Boolean

布尔值,指示指定流中是否没有数据包。若指定流为空或发生可恢复错误,值为 OPC_TRUE,否则为 OPC_FALSE。

示例

/* obtain the object ID of remote telemetry processor */
node_objid = op_id_from_name (0, OPC_OBJTYPE_NODE_FIXED, "tlm_node");
proc_objid = op_id_from_name (node_objid, OPC_OBJTYPE_PROC, "tlm_proc");

/* create a packet */
oc_pkptr = op_pk_create (128);

/* stuff packet with operation code */
op_pk_fd_set (oc_pkptr, 0, OPC_FIELD_TYPE_INTEGER, OPCODE_ACTIVATE, 0);

/* deliver the packet to remote processor under forced conditions */
op_pk_deliver_forced (oc_pkptr, proc_objid, 0);

/* check to see if remote processor responded with quiet packet; */
/* if so, obtain the response code */
if (op_strm_empty (0) == OPC_FALSE)
	{
	resp_pkptr = op_pk_get (0);
	op_pk_fd_get (resp_pkptr, 0, &resp_code);
	}

详情

输入流最初为空。数据包通过两种技术放入输入流:

  • 已连接的输入流接收通过 op_pk_send…() 系列内核过程传输的数据包,其源模块通过物理数据包流与之相连。
  • 未连接的输入流只能接收通过 op_pk_deliver…() 系列内核过程传输的数据包,其源处理器或队列甚至不必与目标模块位于同一节点中。

从输入流中移除数据包同样有两种技术:

  • 数据包可以使用内核过程 op_pk_get() 逐个移除,然后由过程算法加以处理。
  • 当数据包不再有用时,可以使用内核过程 op_strm_flush() 将其成批地破坏性移除。

内核过程 op_pk_get() 可以成功地应用于未连接的正值输入流索引。 这种调用的效果是从当前最大流预分配输入流直到所指定的索引。

这与用于支持在未占用流上投递数据包的动态流分配机制是一致的。

用途

提供一种判定输入流是否为空的机制。此内核过程通常作为过程 FSM 中的条件使用,或用于 if 语句的条件子句,以括起一组仅当某个特定输入流包含数据包时才应执行的语句。通常,被括起的语句会尝试处理输入流中的一个或多个数据包,通过内核过程 op_pk_get() 将其移除。已在模块输入流中排队、但在关联过程的下一次调用期间未被读入和处理的数据包,将继续保持排队状态,直到在后续某次过程调用中被移除。

错误

  • 程序中止:内核过程需要过程上下文。
  • 程序中止:分配(<n> 个)输入流失败。
  • 可恢复错误:输入流索引(<strm_index>)超出范围。

参考

  • 使用内核过程 op_strm_pksize() 确定输入流中排队的数据包数量
  • 使用内核过程 op_strm_flush() 移除输入流中的所有数据包
  • 使用内核过程 op_pk_get() 从输入流中移除第一个数据包并获得指向它的指针

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