op_prg_log_entry_write_t()
摘要
向指定的日志句柄写入一条带有指定时间戳的日志条目。
语法
op_prg_log_entry_write_t (handle, tval, entry_text, …)
| 参数 | 类型 | 说明 |
|---|---|---|
handle |
Log_Handle |
日志句柄,标识接收该条目的仿真日志。 |
tval |
double |
要记录在日志条目中的仿真时间(以秒计)。 |
entry_text |
const char* |
包含日志条目文本的字符串。该字符串可以包含与 C 语言 printf 命令类似的转换说明符(%d、%s 等)。 |
… |
various |
零个或多个参数,表示要替换到 entry_text 中的值。 |
返回类型
void
无返回值。
示例
/* Write a pre-sim message to the log */
op_prg_log_entry_write_t (sim_log_handle, 0.0,
"Duplicate IP addr (%s) found.\n", ip_addr_str);
详情
该内核过程向仿真日志追加一条新的日志条目。仿真日志只能由类型为 Log_Handle 且已通过 op_prg_log_handle_create() 初始化的变量引用。
可以使用 tval 指定 Time 列的值。
用途
提供向指定仿真日志写入条目的机制。该内核过程与 op_prg_log_entry_write() 完全相同,不同之处在于它还允许指定要包含在日志条目中的仿真时间。
错误
- 可恢复错误:日志句柄无效。
- 可恢复错误:句柄格式为空。
- 程序中止:段错误/总线错误(由于在带转换说明符的字符串之后跟了无效参数)。
参考
- 使用内核过程 op_prg_log_handle_create() 创建日志句柄
- 使用内核过程 op_prg_log_entry_write() 写入带有自动生成时间戳的日志条目
- 使用内核过程 op_prg_log_entry_write_options() 写入省略所选列值的日志条目
- 使用内核过程 op_prg_log_handle_severity_set() 在写入日志条目之前更改严重级别