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

This class provides a mechanism for describing a metric&period;

== Synopsis

Declared in `&lt;balm&lowbar;metricdescription&period;h&gt;`

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

== Description

A `MetricDescription` holds the category to which the metric belongs, and a null&hyphen;terminated string containing the name of the metric&period;

== 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&period;
|===


== 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`&period;
| xref:BloombergLP/balm/MetricDescription/category.adoc[`category`] 
| Return the address of the non&hyphen;modifiable category object indicating the category of the metric described by this object&period;
| xref:BloombergLP/balm/MetricDescription/format.adoc[`format`] 
| Return a shared pointer to the non&hyphen;modifiable format for this metric description&period;
| xref:BloombergLP/balm/MetricDescription/name.adoc[`name`] 
| Return the address of the non&hyphen;modifiable, null&hyphen;terminated string containing the name of the described metric&period;
| xref:BloombergLP/balm/MetricDescription/preferredPublicationType.adoc[`preferredPublicationType`] 
| Return the preferred publication type of this metric&period;
| xref:BloombergLP/balm/MetricDescription/print.adoc[`print`] 
| Print the category and name of this metric description&period;
| xref:BloombergLP/balm/MetricDescription/printDescription.adoc[`printDescription`] 
| Print the properties of this metric description&period;
| xref:BloombergLP/balm/MetricDescription/setCategory.adoc[`setCategory`] 
| Set the category of this metric description to the object at the specified `category` address&period;
| xref:BloombergLP/balm/MetricDescription/setFormat.adoc[`setFormat`] 
| Set the format for this metric description to the specified `format`&period;
| xref:BloombergLP/balm/MetricDescription/setName.adoc[`setName`] 
| Set the name of this metric description to the specified `name`&period;
| xref:BloombergLP/balm/MetricDescription/setPreferredPublicationType.adoc[`setPreferredPublicationType`] 
| Set the preferred publication type of this metric to the specified `type`&period;
| xref:BloombergLP/balm/MetricDescription/setUserData.adoc[`setUserData`] 
| Associate the specified `value` with the specified data `key`&period;
| xref:BloombergLP/balm/MetricDescription/userData.adoc[`userData`] 
| Return the non&hyphen;modifiable value associated with the specified user&hyphen;data `key`&period;
|===



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