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() 从输入流中移除第一个数据包并获得指向它的指针