[#BloombergLP-balm-Metric-2constructor-02]
= xref:BloombergLP.adoc[BloombergLP]::xref:BloombergLP/balm.adoc[balm]::xref:BloombergLP/balm/Metric.adoc[Metric]::Metric
:relfileprefix: ../../../
:mrdocs:

Constructors

== Synopses

Declared in `<balm_metric.h>`

Create a metric object that will record values for the same metric (i.e., using the same `Collector` object) as the specified `original` metric. If the `original` metric is inactive (i.e., `isActive()` is `false`), then this metric will be similarly inactive.


[source,cpp,subs="verbatim,replacements,macros,-callouts"]
----
xref:BloombergLP/balm/Metric/2constructor-04.adoc[Metric](xref:BloombergLP/balm/Metric.adoc[Metric] const& original);
----

[.small]#xref:BloombergLP/balm/Metric/2constructor-04.adoc[_» more..._]#

Create a metric object to collect values for the metric implied by the specified `collector` (i.e., `collector‐>metricId()`). The behavior is undefined unless `collector` is a valid address of a `Collector` object and `collector` has a valid id (i.e., `collector‐>metricId().isValid()`).


[source,cpp,subs="verbatim,replacements,macros,-callouts"]
----
explicit
xref:BloombergLP/balm/Metric/2constructor-0b3.adoc[Metric](xref:BloombergLP/balm/Collector.adoc[Collector]* collector);
----

[.small]#xref:BloombergLP/balm/Metric/2constructor-0b3.adoc[_» more..._]#

Create a metric object to collect values for the specified `metricId`. Optionally specify a metrics `manager` used to provide a collector for `metricId`. If `manager` is 0, use the default metrics manager, if initialized; if `manager` is 0 and the default metrics manager has not been initialized, place this metric object in the inactive state (i.e., `isActive()` is `false`) in which case instance methods that would otherwise update the metric will have no effect. The behavior is undefined unless `metricId` is a valid id returned by the `MetricRepository` object owned by the indicated metrics manager.


[source,cpp,subs="verbatim,replacements,macros,-callouts"]
----
explicit
xref:BloombergLP/balm/Metric/2constructor-0b2.adoc[Metric](
    xref:BloombergLP/balm/MetricId.adoc[MetricId] const& metricId,
    xref:BloombergLP/balm/MetricsManager.adoc[MetricsManager]* manager = 0);
----

[.small]#xref:BloombergLP/balm/Metric/2constructor-0b2.adoc[_» more..._]#

Create a metric object to collect values for the metric identified by the specified null‐terminated strings `category` and `name`. Optionally specify a metrics `manager` used to provide a collector for the indicated metric. If `manager` is 0, use the default metrics manager, if initialized; if `manager` is 0 and the default metrics manager has not been initialized, place this metric object in the inactive state (i.e., `isActive()` is `false`) in which case instance methods that would otherwise update the metric will have no effect.


[source,cpp,subs="verbatim,replacements,macros,-callouts"]
----
xref:BloombergLP/balm/Metric/2constructor-0a.adoc[Metric](
    char const* category,
    char const* name,
    xref:BloombergLP/balm/MetricsManager.adoc[MetricsManager]* manager = 0);
----

[.small]#xref:BloombergLP/balm/Metric/2constructor-0a.adoc[_» more..._]#


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