[#BloombergLP-balm-MetricDescription]
= xref:BloombergLP.adoc[BloombergLP]::xref:BloombergLP/balm.adoc[balm]::MetricDescription
:relfileprefix: ../../
:mrdocs:

This class provides a mechanism for describing a metric.

== Synopsis

Declared in `<balm_metricdescription.h>`

[source,cpp,subs="verbatim,replacements,macros,-callouts"]
----
class MetricDescription;
----

== Description

A `MetricDescription` holds the category to which the metric belongs, and a null‐terminated string containing the name of the metric.

== Type Aliases

[cols="1,4"]
|===
| Name| Description
| xref:BloombergLP/balm/MetricDescription/UserDataKey.adoc[`UserDataKey`] 
| A key used to refer to a data value associated with a metric.
|===


== Member Functions

[cols="1,4"]
|===
| Name| Description
| xref:BloombergLP/balm/MetricDescription/2constructor.adoc[`MetricDescription`]         [.small]#[constructor]#
| Create a metric description for the specified `category` and the specified `name`.
| xref:BloombergLP/balm/MetricDescription/category.adoc[`category`] 
| Return the address of the non‐modifiable category object indicating the category of the metric described by this object.
| xref:BloombergLP/balm/MetricDescription/format.adoc[`format`] 
| Return a shared pointer to the non‐modifiable format for this metric description.
| xref:BloombergLP/balm/MetricDescription/name.adoc[`name`] 
| Return the address of the non‐modifiable, null‐terminated string containing the name of the described metric.
| xref:BloombergLP/balm/MetricDescription/preferredPublicationType.adoc[`preferredPublicationType`] 
| Return the preferred publication type of this metric.
| xref:BloombergLP/balm/MetricDescription/print.adoc[`print`] 
| Print the category and name of this metric description.
| xref:BloombergLP/balm/MetricDescription/printDescription.adoc[`printDescription`] 
| Print the properties of this metric description.
| xref:BloombergLP/balm/MetricDescription/setCategory.adoc[`setCategory`] 
| Set the category of this metric description to the object at the specified `category` address.
| xref:BloombergLP/balm/MetricDescription/setFormat.adoc[`setFormat`] 
| Set the format for this metric description to the specified `format`.
| xref:BloombergLP/balm/MetricDescription/setName.adoc[`setName`] 
| Set the name of this metric description to the specified `name`.
| xref:BloombergLP/balm/MetricDescription/setPreferredPublicationType.adoc[`setPreferredPublicationType`] 
| Set the preferred publication type of this metric to the specified `type`.
| xref:BloombergLP/balm/MetricDescription/setUserData.adoc[`setUserData`] 
| Associate the specified `value` with the specified data `key`.
| xref:BloombergLP/balm/MetricDescription/userData.adoc[`userData`] 
| Return the non‐modifiable value associated with the specified user‐data `key`.
|===



[.small]#Created with https://www.mrdocs.com[MrDocs]#