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)