ACE
6.1.6
|
Provides simple statistical analysis. More...
#include <Stats.h>
Public Member Functions | |
ACE_Stats (void) | |
Default constructor. | |
int | sample (const ACE_INT32 value) |
ACE_UINT32 | samples (void) const |
Access the number of samples provided so far. | |
ACE_INT32 | min_value (void) const |
Value of the minimum sample provided so far. | |
ACE_INT32 | max_value (void) const |
Value of the maximum sample provided so far. | |
void | mean (ACE_Stats_Value &mean, const ACE_UINT32 scale_factor=1) |
int | std_dev (ACE_Stats_Value &std_dev, const ACE_UINT32 scale_factor=1) |
int | print_summary (const u_int precision, const ACE_UINT32 scale_factor=1, FILE *=stdout) const |
void | reset (void) |
Initialize internal state. | |
void | dump (void) const |
Print summary statistics to stdout. |
Static Public Member Functions | |
static void | quotient (const ACE_UINT64 dividend, const ACE_UINT32 divisor, ACE_Stats_Value "ient) |
Utility division function, for ACE_UINT64 dividend. | |
static void | quotient (const ACE_Stats_Value ÷nd, const ACE_UINT32 divisor, ACE_Stats_Value "ient) |
Utility division function, for ACE_Stats_Value dividend. | |
static void | square_root (const ACE_UINT64 n, ACE_Stats_Value &square_root) |
Protected Attributes | |
u_int | overflow_ |
ACE_UINT32 | number_of_samples_ |
Number of samples. | |
ACE_INT32 | min_ |
Minimum sample value. | |
ACE_INT32 | max_ |
Maximum sample value. | |
ACE_Unbounded_Queue< ACE_INT32 > | samples_ |
The samples. |
Provides simple statistical analysis.
Simple statistical analysis package. Prominent features are:
Example usage:
* ACE_Stats stats; * for (u_int i = 0; i < n; ++i) * { * const ACE_UINT32 sample = ...; * stats.sample (sample); * } * stats.print_summary (3); *
|
inline |
Default constructor.
|
inline |
Print summary statistics to stdout.
|
inline |
Value of the maximum sample provided so far.
void ACE_Stats::mean | ( | ACE_Stats_Value & | mean, |
const ACE_UINT32 | scale_factor = 1 |
||
) |
Access the mean of all samples provided so far. The fractional part is to the specified number of digits. E.g., 3 fractional digits specifies that the fractional part is in thousandths.
|
inline |
Value of the minimum sample provided so far.
int ACE_Stats::print_summary | ( | const u_int | precision, |
const ACE_UINT32 | scale_factor = 1 , |
||
FILE * | file = stdout |
||
) | const |
Print summary statistics. If scale_factor is not 1, then the results are divided by it, i.e., each of the samples is scaled down by it. If internal overflow is reached with the specified scale factor, it successively tries to reduce it. Returns -1 if there is overflow even with a 0 scale factor.
|
static |
Utility division function, for ACE_UINT64 dividend.
|
static |
Utility division function, for ACE_Stats_Value dividend.
void ACE_Stats::reset | ( | void | ) |
Initialize internal state.
int ACE_Stats::sample | ( | const ACE_INT32 | value | ) |
Provide a new sample. Returns 0 on success, -1 if it fails due to running out of memory, or to rolling over of the sample count.
|
inline |
Access the number of samples provided so far.
|
static |
Sqrt function, which uses an oversimplified version of Newton's method. It's not fast, but it doesn't require floating point support.
int ACE_Stats::std_dev | ( | ACE_Stats_Value & | std_dev, |
const ACE_UINT32 | scale_factor = 1 |
||
) |
Access the standard deviation, whole and fractional parts. See description of {mean} method for argument descriptions.
|
protected |
Maximum sample value.
|
protected |
Minimum sample value.
|
protected |
Number of samples.
|
protected |
Internal indication of whether there has been overflow. Contains the errno corresponding to the cause of overflow.
|
protected |
The samples.