NAME

       pmPrintValue - print a performance metric value

C SYNOPSIS

       #include <stdio.h>
       #include <pcp/pmapi.h>

       void pmPrintValue(FILE *f, int valfmt, int type, const pmValue *val, int minwidth);

       cc ... -lpcp

DESCRIPTION

       The value of a single performance metric (as identified by val) is printed on the standard
       I/O stream identified by f.

       The value of the performance metric is interpreted according  to  the  format  of  val  as
       defined  by valfmt (from a pmValueSet within a pmResult structure; see pmFetch(3)) and the
       generic description of the metrics type passed in via type.

       The value for type is typically extracted from a pmDesc structure,  following  a  call  to
       pmLookupDesc(3) for a particular performance metric.

       The output will be optionally padded to be at least minwidth characters wide.

       pmPrintValue  is  most useful for displaying values of performance metrics from pmFetch(3)
       (which returns a set of valfmt and val pairs for each requested metric),  based  upon  the
       metrics type as returned from pmLookupDesc(3).

SEE ALSO

       PMAPI(3),  pmAtomStr(3),  pmConvScale(3),  pmExtractValue(3), pmFetch(3), pmLookupDesc(3),
       pmTypeStr(3) and pmUnitsStr(3).