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) 在不同标志下的结果

用途
提供了一种相对于指定时间“查找”特定事件的机制。
**注意:**该内核过程仅在顺序仿真上下文中有效。在并行仿真中,当前时间单元中的事件可能根据各线程的行为以不同的方式执行,此时它将表现为当前事件之后没有任何事件。
错误
- 可恢复错误:查找时间(
<time>)小于当前仿真时间。 - 可恢复错误:查找标志(
<flag>)无法识别。
参考
- 使用内核过程 op_ev_current() 获取当前事件的 Evhandle
- 使用内核过程 op_ev_next() 获取后续事件的事件句柄(Evhandle)
- 使用内核过程 op_ev_next_local() 获取后续本地事件的事件句柄(Evhandle)