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):试图使用未注册的统计量句柄。

参考

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