Code Blocks 菜单操作

本节包含 Process Editor 中 Code Blocks 菜单可用操作的说明与过程。该菜单上出现的各项按字母顺序列出如下:

注: 对代码块的更改在你选择 File > Save 之前不会被保存。

诊断块

该操作呈现一个对话框,允许为进程模型定义诊断块。诊断块包含向标准输出设备发送诊断信息的 C 或 C++ 语言语句。这通常通过调用标准 I/O 函数 printf() 或打印消息的 Riverbed 内核过程(KP)来完成。诊断块中的语句可以完全访问进程的状态变量,但不能访问临时变量。因此,诊断语句可以生成进程内部状态的报告。

诊断块过程由仿真内核通过仿真调试器(ODB)调用。ODB 通过带 -debug 命令行标志运行仿真来访问,相关说明参见“Simulation Debugger (ODB)”第 39 页。

诊断块对话框支持对 C 或 C++ 语言语句的添加、删除或修改。一个典型的诊断块编辑面板如下图所示。

图 200:诊断块编辑面板

诊断块编辑面板

函数块

该操作呈现一个对话框,允许为进程定义函数块。函数块包含与该进程关联的 C 或 C++ 语言函数,可以被进程中的任何语句调用,包括与状态、转移和其他块关联的语句。

函数块支持添加、删除或修改任意数量的 C 或 C++ 语言函数。一个典型的函数块对话框如下图所示。

图 201:函数块编辑面板

函数块编辑面板

头块

该操作呈现一个对话框,允许你为当前进程定义头块。进程模型定义中的头块通常包含以下元素中的一个或多个:

  • OPC_COMPILE_CPP(表示使用 C++ 的可选记号)
  • #include 指令(用于包含 C 或 C++ 头文件)
  • #define 指令(用于常量与宏)
  • struct 数据类型定义
  • typedef 数据类型定义
  • class 定义(用于 C++)
  • extern 变量声明
  • 全局变量声明
  • 注释

头块主要用于声明将在进程模型执行体语句和条件语句中引用的符号常量、宏和数据类型。

头块支持对声明和预处理指令的添加、删除或修改。一个典型的头块对话框如下所示。

图 202:头块编辑面板

头块编辑面板

如果进程模型要按 C++ 编译,可以在头文件中包含记号 OPC_COMPILE_CPP。如果这样做,包含该记号的那一行将不会出现在生成的代码中。(通常,C++ 编译通过 Compile > Enable C++ Code Generation 选项来指明。)

状态变量

该操作呈现一个表,你可以在其中为进程声明状态变量。状态变量是指从一个进程调用到下一个调用保留其取值的变量。它们不同于临时变量(在临时变量中说明),临时变量只在单次进程模型调用的时间跨度内保留其取值。有关状态变量(包括命名限制)的更详细说明,参见“State Variables”第 195 页。

图 203:状态变量表

状态变量表

要按类型或名称对状态变量表排序,请单击某个标题单元格。重复单击可切换排序顺序。要在表中查找文本字符串,请在 Name 列下方的字段中输入该字符串,然后单击 Find Next 按钮。

Edit Ascii 按钮打开一个编辑面板,其中包含以 C 或 C++ 语言的变量声明语法书写的状态变量。在该编辑面板中,你可以添加、删除或修改状态变量声明。但请注意,每个状态变量声明必须位于状态变量编辑面板的单独一行之内。此外,每个状态变量的名称之前必须紧跟着一个反斜杠字符(“\”),如下图所示。

图 204:状态变量声明

状态变量声明

临时变量

该操作呈现一个对话框,允许为进程声明临时变量。临时变量是指从一个进程调用到下一个调用不保留其取值的变量。它们只在单次进程调用的时间跨度内存储取值,通常用作“草稿”变量。临时变量只能在状态执行体中访问,如“Variables”第 192 页中所述。

临时变量不同于状态变量(参见状态变量),后者从一个进程调用到下一个调用保留其取值。当进程在仿真中稍后被恢复时,状态变量仍具有其先前的取值,而临时变量则不然。临时变量在 C 或 C++ 语言中实现为进程模型函数的自动变量。它们的声明遵循 C 和 C++ 应用于自动变量的相同规则。

临时变量可以仅在进程代码中可用,也可以包含在终止块或诊断块中。详见 Include Temporary Variables in Diagnostic/Termination Block。

Temporary Variables 对话框允许对临时变量声明进行添加、修改或删除。一个典型的 Temporary Variables 对话框如下图所示。

图 205:临时变量编辑面板

临时变量编辑面板

终止块

该操作呈现一个编辑面板,允许你为进程模型定义终止块。终止块包含在动态进程被销毁之前刚刚执行的 C 或 C++ 语言语句。例如,如果一个动态进程已经分配了内存(例如列表),终止块可用于在进程被销毁之前释放这些内存。终止块不会为根进程执行。

终止块由仿真内核通过 op_pro_destroy() 内核过程调用,该内核过程用于销毁动态进程。通过终止不再有用的动态进程,你可以为其他进程释放内存。有关该 KP 的更多信息,参见第 10 页上的 op_pro_destroy()。有关根进程与动态进程的更多信息,参见第 5 章“Process Domain”第 165 页。

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