op_sim_end()
摘要
终止仿真,关闭向量输出文件,并打印若干指定行。
语法
op_sim_end (line0, line1, line2, line3)
| 参数 | 类型 | 说明 |
|---|---|---|
line0 |
const char* |
消息行 #0 |
line1 |
const char* |
消息行 #1 |
line2 |
const char* |
消息行 #2 |
line3 |
const char* |
消息行 #3 |
返回类型
void
无返回值(调用 op_sim_end() 之后的任何代码都不会被执行)。
示例
摘自:示例模型(models/std/hssb);进程模型(hssb_appl);状态(INIT);enter execs。
/* Obtain self ID */
myid = op_id_self ();
/* Obtain the attribute values. */
op_ima_obj_attr_get (myid, "address", &my_address);
op_ima_obj_attr_get (myid, "average_interarrival_time", &ia_time);
op_ima_obj_attr_get (myid, "average_service_time", &service_time);
op_ima_obj_attr_get (myid, "ack_service_time", &ack_service_time);
op_ima_sim_attr_get (OPC_IMA_INTEGER, "number_of_nodes", &number_of_nodes);
ppid = op_topo_parent (myid);
op_ima_obj_attr_get (ppid, "name", name);
/* Verify the address. */
if (my_address > number_of_nodes)
{
op_sim_end ("err: appl process: address > number of nodes", "", "", "");
/* The rest of the block will not be executed */
}
详情
该内核过程在仿真的标称持续时间(由 duration 环境属性决定)结束之前终止仿真。由于仿真已结束,结束仿真中断会被投递给所有启用了 endsim intrpt 属性的其他处理器和队列。(调用该内核过程的模块不会收到结束仿真中断。)
从图形环境运行仿真时,消息窗口中只会显示所指定的四行中的前三行,但所有行都会出现在同时输出到 shell 和 DES 日志的内容中。
用途
提供了一种根据可调用该内核过程的进程的动态状态,以受控方式有条件地终止仿真的机制。该内核过程最常用于以下两种情形:
- 仿真逻辑捕获到异常错误状况,使仿真继续推进不再必要
- 仿真逻辑基于统计收敛或其他仿真完成状态指标发现了停止条件。
在这两种情形下,通常都重要的是让仿真以受控方式结束,从而使仿真一直在写入的向量和标量输出文件被正确完成并关闭。
错误
- 程序中止:段违例。(由于无效或格式错误的消息字符串)
参考
- 使用内核过程 op_sim_time() 确定当前仿真时间
- 使用内核过程 op_stat_scalar_write() 写出汇总仿真结果的标量统计量值
- 使用内核过程 op_sim_message() 或 op_sim_error() 在不终止仿真的情况下向标准输出设备打印消息