op_stat_valid()
摘要
检查统计量句柄是否有效。
语法
op_stat_valid (shandle)
| 参数 | 类型 | 说明 |
|---|---|---|
shandle |
Stathandle |
标识全局或局部统计量的统计量句柄。[统计量句柄可通过内核过程 op_stat_reg() 获得。] |
返回类型
Boolean
若句柄有效,返回常量 OPC_TRUE;若句柄无效,返回常量 OPC_FALSE。
示例
void write_stat(stathandle sh, double val)
{
if (op_stat_valid (sh) == OPC_TRUE)
{
/* ... appropriate additional tests, code... */
op_stat_write(sh, val);
}
}
详情
内核过程 op_stat_valid() 用于确认统计量句柄是否有效。
该内核过程的一个常见用途是限制对局部和全局统计量的处理。只有在 View Results 窗口中由用户通过复选框启用的统计量才会向应用程序返回 OPC_TRUE 值;未选中的复选框返回 OPC_FALSE 值。因此,应用程序只处理来自已验证(TRUE)的统计量句柄的数据。这提高了计算效率并缩短了处理时间。
用途
验证统计量句柄。
错误
无。
参考
- 使用内核过程 op_stat_reg() 获取统计量句柄