op_prg_odb_print_major()
摘要
以 ODB 跟踪语句的格式,从主缩进层级开始向标准输出设备打印一串字符串。
语法
op_prg_odb_print_major (string0, string1, …, OPC_NIL)
| 参数 | 类型 | 说明 |
|---|---|---|
string0 |
const char* |
要打印的第一个字符串 |
string1 |
const char* |
要打印的第二个字符串 |
… |
const char* |
要打印的其余字符串 |
OPC_NIL |
字符串序列终止符。[本内核过程的参数构成一个可变长度的字符串序列,打印到标准输出设备。该序列以符号常量 OPC_NIL 终止。] |
返回类型
void
无返回值。
示例
节选自:示例模型(std/tcp);进程模型(tcp);函数块;函数(tcp_state_info())。
sprintf (str0, "rcv requests pending : (%d)", num_rcvs_allowed);
sprintf (str1, "local receive window : (%d)", receive_window);
sprintf (str2, "remote receive window : (%d)", remote_window);
op_prg_odb_print_major ("Window-Related Variables", str0, str1, str2, OPC_NIL);
sprintf (str0, "send unacked : (%d)", send_unacked);
sprintf (str1, "send_next : (%d)", send_next);
sprintf (str2, "receive next : (%d)", receive_next);
op_prg_odb_print_minor (str0, str1, str2, OPC_NIL);
标准输出设备上显示的示例输出:
| Window-Related Variables
| rcv requests pending : (3)
| local receive window : (6400)
| remote receive window : (10788)
| send unacked : (4525)
| send_next : (5000)
| receive_next : (1200)
详情
ODB 跟踪语句的对齐策略为:
- 第 17 列:星号表示内核过程调用,竖线表示由
op_prg_odb_print_major()或 op_prg_odb_print_minor() 打印的用户诊断语句 - 第 25 列:内核过程调用的参数与返回值,以及
op_prg_odb_print_major()打印的第一个字符串(即主缩进层级) - 第 33 列:
op_prg_odb_print_major()打印的第二个至最后一个字符串,以及 op_prg_odb_print_minor() 打印的全部字符串(即次缩进层级)
注意: 只有传入本内核过程的第一个字符串出现在主缩进层级;所有其他字符串参数都出现在次缩进层级。
本内核过程在优化仿真内核下使用时不执行任何操作。
用途
为按 ODB 跟踪语句所使用的标准格式打印诊断消息提供了一种机制。主缩进层级突出显示单条概要或横幅消息,用以解释其后的诊断消息。注意,本内核过程在仿真未运行于 ODB 之下时并不会在内部限制其输出,因此对本内核过程的调用通常嵌入在依赖于 ODB 中跟踪处于激活状态的条件块内(例如由 op_prg_odb_trace_active()、op_prg_odb_ltrace_active() 或 op_prg_odb_pktrace_active() 判断)。
错误
- 程序中止:段违例,由以下一种或多种情况引起:(1) 字符串指针无效;(2) 字符串未以 null 终止;(3) 字符串序列未以符号常量
OPC_NIL终止。
参考
- 使用内核过程 op_prg_odb_print_minor() 在次缩进层级打印跟踪信息
- 使用函数
printf()向标准设备打印 - 使用内核过程 op_prg_odb_trace_active() 判断完整跟踪或模块跟踪是否处于激活状态
- 使用内核过程 op_prg_odb_ltrace_active() 判断带标签跟踪是否处于激活状态
- 使用内核过程 op_prg_odb_pktrace_active() 判断 Packet 跟踪是否处于激活状态