PMPRINTVALUE(3)            Library Functions Manual            PMPRINTVALUE(3)

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).

Performance Co-Pilot                  PCP                      PMPRINTVALUE(3)