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

This class defines an in‐core value‐semantic type used to identify a metric.

== Synopsis

Declared in `<balm_metricid.h>`

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

== Description

A `MetricId` object's value is the _address_ of a non‐modifiable `MetricDescription` object. In addition, a `MetricDescription` object provides auxiliary methods, `category`, `categoryName`, and `name`, that enable access to the properties of the held `MetricDescription`. Two `MetricId` objects have the same value if the values of their respective `MetricDescription` object _addresses_ are the same.

== Member Functions

[cols="1,4"]
|===
| Name| Description
| xref:BloombergLP/balm/MetricId/2constructor-0c.adoc[`MetricId`]         [.small]#[constructor]#
| Constructors
| xref:BloombergLP/balm/MetricId/category.adoc[`category`] 
| Return the address of the non‐modifiable `Category` object identifying the category with which this metric id is associated.
| xref:BloombergLP/balm/MetricId/categoryName.adoc[`categoryName`] 
| Return the address of the non‐modifiable name for the category with which this metric id is associated.
| xref:BloombergLP/balm/MetricId/description-07.adoc[`description`] 
| `description` overloads
| xref:BloombergLP/balm/MetricId/isValid.adoc[`isValid`] 
| Return `true` if this metric id object contains the address of a valid `MetricDescription` object, and false `otherwise`.
| xref:BloombergLP/balm/MetricId/metricName.adoc[`metricName`] 
| Return the address of the non‐modifiable name of this metric id.
| xref:BloombergLP/balm/MetricId/print.adoc[`print`] 
| Print this metric id to the specified output `stream` in some single‐line human‐readable form, and return a reference to the modifiable `stream`.
| xref:BloombergLP/balm/MetricId/2conversion.adoc[`operator BloombergLP::bslmf::NestedTraitDeclaration<MetricId, is_trivially_copyable>`] 
| Declare that this type is trivially copyable.
|===


== Non-Member Functions

[cols="1,4"]
|===
| Name| Description
| xref:BloombergLP/balm/operator_not_eq-0f.adoc[`operator!=`]
| Return `true` if the specified `lhs` and `rhs` metric ids do not have the same value and `false` otherwise.
| xref:BloombergLP/balm/operator_lt.adoc[`operator<`]
| Return `true` if the specified `lhs` metric id is less than (ordered before) the specified `rhs` metric id, and return `false` otherwise'.
| xref:BloombergLP/balm/operator_eq-0f.adoc[`operator==`]
| Return `true` if the specified `lhs` and `rhs` metric ids have the same value and `false` otherwise.
|===


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