#include <nng/nng.h>
typedef struct nng_stat nng_stat;
enum {
NNG_STAT_SCOPE,
NNG_STAT_LEVEL,
NNG_STAT_COUNTER,
NNG_STAT_STRING,
NNG_STAT_BOOLEAN,
NNG_STAT_ID
};
int nng_stat_type(nng_stat *stat);
This documentation is for the TIP (development tree) of NNG and may represent unreleased changes or functionality that is experimental, and is subject to change before release. The latest released version is v1.8.0. See the documentation for v1.8.0 for the most up-to-date information. |
nng_stat_type(3)
NAME
nng_stat_type - get statistic type
SYNOPSIS
DESCRIPTION
The nng_stat_type()
function returns the type of the statistic stat.
The returned type will be one of the following values:
NNG_STAT_SCOPE
-
This is a placeholder providing scope, and carries no value on its own. Instead it is a parent node with child statistics (see
nng_stat_child()
.) NNG_STAT_LEVEL
-
This is a numeric statistic, but its value is a level, so rate calculations based on changes in this value should not be considered significant.
NNG_STAT_COUNTER
-
This is a numeric statistic that represents an increasing count, typically of events, messages, or bytes. Frequently, it is interesting to consider changes in this statistic divided by time to obtain a rate. (For example, throughput might be calculated as changes in a byte counter divided by the interval over which the change occurred.)
NNG_STAT_STRING
-
This is a string, and carries no numeric value. Instead the
nng_stat_string()
function should be used to obtain the value. NNG_STAT_BOOLEAN
-
This is a boolean value. The
nng_stat_value()
function will return zero to represent afalse
value, and one to represent atrue
value.
NNG_STAT_ID
:
The statistic is a numeric ID.
These are generally immutable values that represent an identity that might
be used with another interface.
For NNG_STAT_COUNTER and NNG_STAT_LEVEL statistics, the
nng_stat_unit() function will provide more
detail about the units measured by the static.
|
RETURN VALUES
The statistic type for stat.
ERRORS
None.