PMNUMBERSTR - Online Linux Manual Page

Section : 3
Updated : PCP
Source : Performance Co-Pilot

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 ( \f(CRd\f1 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.