op_stat_write()
摘要
向指定的统计量写入一个 (time,value) 对。值作为该内核过程的参数给出,时间则为当前仿真时间。
语法
op_stat_write (stat_handle, value)
| 参数 | 类型 | 说明 |
|---|---|---|
stat_handle |
Stathandle |
标识接收更新值的全局或局部统计量的统计量句柄 [统计量句柄可通过内核过程 op_stat_reg() 获得。] |
value |
double |
要写入指定统计量的值。 |
返回类型
void
无返回值。
示例
/* obtain the arriving packet */
pkptr = op_pk_get (INPUT_STRM);
/* determine the bulk size of the packet */
bulk_size = op_pk_bulk_size_get (pkptr);
/* If the statistic handle for received packet size has not yet */
/* been initialized, do so now. */
if (pk_size_init == OPC_FALSE)
{
pk_size_shandle = op_stat_reg ("Packet Size (bits)", OPC_STAT_INDEX_NONE,
OPC_STAT_GLOBAL);
pk_size_init = OPC_TRUE;
}
/* write out the bulk size of the packet as a global statistic */
op_stat_write (pk_size_shandle, (double) bulk_size);
/* destroy the now useless packet */
op_pk_destroy (pkptr);
详情
该内核过程向指定统计量的输出向量追加一个新的 (time, value) 对。统计量只能通过类型为 Stathandle、且已通过调用内核过程 op_stat_reg() 初始化的变量来引用。使用初始化不当的句柄调用该内核过程可能导致可恢复的仿真错误。
仿真模型中的不同过程若使用同一统计量句柄,可以通过该内核过程向同一输出向量写入值。内核过程 op_stat_reg() 利用传入的统计量名称与同一统计量的其他来源“会合(rendezvous)”,从而实现将数据多路复用到单个输出向量。
在同一仿真时间内多次调用 op_stat_write() 会按顺序记录,彼此不会覆盖。
要在输出向量文件中生成数据,必须使用在 Probe Editor 中定义的探测对象,或通过 Project Editor 中的 Select statistics 操作选定的探测对象对统计量进行探测。包含该探测的探测文件名由仿真的 probe 属性指定。要记录所有全局统计量,设置仿真的 record_gstats 属性。
若捕获模式是按时间相除的模式,且统计量在指定的时间段内有效,则必须向系统指明该时段何时结束。方法是在该时段结束时用 op_stat_write() 向该统计量写入零。
用途
向输出向量贡献一个新值,并以当前仿真时间作为标记。
如果 Stathandle 指向一个已连接统计量连线(statistic wire)的局部统计量,且该连线的触发条件满足,则会为统计量连线的目标模块安排一次中断。
错误
- 程序中止(Program Abort):段违例(Segmentation violation)。(由无效统计量句柄引起)
- 可恢复错误(Recoverable Error):试图使用未注册的统计量句柄。
参考
- 使用内核过程 op_stat_local_read() 读取输入统计量的当前值
- 使用内核过程 op_stat_write_t() 向输出统计量写入以指定仿真时间标记的值
- 使用内核过程 op_stat_scalar_write() 向标量统计量写入值
- 使用内核过程 op_stat_obj_reg() 访问任意链路、路径、模块或子模块对象的统计量
- 使用内核过程 op_stat_reg() 获取统计量句柄