op_ev_seek_time()

摘要

以指定方式获取指向与指定事件句柄最接近的事件的事件句柄。

语法

op_ev_seek_time (time, flag)
参数 类型 说明
time double 开始查找事件的时间边界
[如果 “sim_time_quantum“ 偏好设置的值不为 0.0,time 将在内部被截断为指定时间量子的整数倍。]
flag int 指定查找类型的标志
[这是一个整数数字代码,表示可能的标志值之一(参见第 12 页的表 52“事件查找模式符号常量“;该标志的可用值也列于详情小节中)。]

返回类型

Evhandle

表示符合查找条件的事件的事件句柄。如果发生错误,将返回无效的事件句柄。

示例

/* Find the first event for the receiver after */
/* 5.0 seconds from the current time and cancel it. */
time = op_sim_time () + 5.0;
event = op_ev_seek_time (time, OPC_EVSEEK_TIME_POST);
while (op_ev_valid (event))
	{
	if (op_ev_dst_id (event) == recv_id)
		{
		op_ev_cancel (event);
		break;
		}
	else
		event = op_ev_next (event);
	}

详情

该内核过程的 flag 参数采用四个符号常量之一:

  • OPC_EVSEEK_TIME_PRE——用于查找指定时间之前紧邻的事件。
  • OPC_EVSEEK_TIME_PREINC——用于查找在指定时间处或之前紧邻的事件。
  • OPC_EVSEEK_TIME_POST——用于查找指定时间之后紧邻的事件。
  • OPC_EVSEEK_TIME_POSTINC——用于查找在指定时间处或之后紧邻的事件。

图 48 说明了这些符号常量所指定的关系。

图 48:op_ev_seek_time (τ, flag) 在不同标志下的结果

op_ev_seek_time (τ, flag) 在不同标志下的结果

用途

提供了一种相对于指定时间“查找”特定事件的机制。

**注意:**该内核过程仅在顺序仿真上下文中有效。在并行仿真中,当前时间单元中的事件可能根据各线程的行为以不同的方式执行,此时它将表现为当前事件之后没有任何事件。

错误

  • 可恢复错误:查找时间(<time>)小于当前仿真时间。
  • 可恢复错误:查找标志(<flag>)无法识别。

参考

  • 使用内核过程 op_ev_current() 获取当前事件的 Evhandle
  • 使用内核过程 op_ev_next() 获取后续事件的事件句柄(Evhandle)
  • 使用内核过程 op_ev_next_local() 获取后续本地事件的事件句柄(Evhandle)

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