NAME¶
pmNumberStr,
pmNumberStr_r - fixed width output format for numbers
C SYNOPSIS¶
#include <pcp/pmapi.h>
const char *pmNumberStr(double
value);
char *pmNumberStr_r(double
value, char *
buf, int
buflen);
cc ... -lpcp
DESCRIPTION¶
pmNumberStr returns the address of a 8-byte buffer that holds a null-byte
terminated representation of
value suitable for output with fixed width
fields. The
pmNumberStr_r function does the same, but stores the result
in a user-supplied buffer
buf of length
buflen, which should
have room for at least 8 bytes.
The value is scaled using multipliers in powers of ``one thousand'' (the decimal
``kilo'') and has a bias that provides greater precision for positive numbers
as opposed to negative numbers.
The format depends on the sign and magnitude of
value as follows (d
represents a decimal digit):
| value range |
format |
|
| > 999995000000000 |
inf? |
| 999995000000000 - 999995000000 |
ddd.ddT |
| 999995000000 - 999995000 |
ddd.ddG |
| 999995000 - 999995 |
ddd.ddM |
| 999995 - 999.995 |
ddd.ddK |
| 999.995 - 0.005 |
ddd.dd |
| 0.005 - -0.005 |
0.00 |
| -0.005 - -99.95 |
-dd.dd |
| -99.995 - -99995 |
-dd.ddK |
| -99995 - -99995000 |
-dd.ddM |
| -99995000 - -99995000000 |
-dd.ddG |
| -99995000000 - -99995000000000 |
-dd.ddT |
| < -99995000000000 |
-inf? |
At the boundary points of the ranges, the chosen format will retain the maximum
number of significant digits.
NOTES¶
pmNumberStr returns a pointer to a static buffer and hence is not
thread-safe. Multi-threaded applications should use
pmNumberStr_r
instead.
SEE ALSO¶
printf(3)
