prg_profile_avg_and_max_get()
摘要
获取 profile 的平均值和最大值。
语法
prg_profile_avg_and_max_get (profile_handle, avg_ptr, max_ptr)
| 参数 | 类型 | 说明 |
|---|---|---|
profile_handle |
PrgT_Profile_Handle |
目标 profile。 |
avg_ptr |
double * |
用于存放按横坐标加权的 profile 平均值的区域。 |
max_ptr |
double * |
用于存放 profile 最大值的区域。 |
返回类型
PrgT_Compcode
如果成功获取平均值和最大值,返回 PrgC_Compcode_Success;否则返回 PrgC_Compcode_Failure(*avg_ptr 和 *max_ptr 将为 0.0)。
头文件
prg_profile_funcs.h
详情
此函数计算 profile 的平均值和最大值。如果 profile 为空或发生错误,*avg_ptr 和 *max_ptr 将为 0.0。
平均值按桶(bucket)的长度加权。如果最后一个值已定义且非零,则最后一个桶的长度未知;在这种情况下,最后一个值按单个单位(时间单位,或横坐标值所定义的单位)加权。
如果 profile 包含未定义的值,则忽略未定义的区域。因此:
- 对于平均值,未定义的值不会计入数值之和或横坐标之和。
- 对于最大值,跳过未定义的值。