[#BloombergLP-balm-MetricSample-appendGroup-00]
= xref:BloombergLP.adoc[BloombergLP]::xref:BloombergLP/balm.adoc[balm]::xref:BloombergLP/balm/MetricSample.adoc[MetricSample]::appendGroup
:relfileprefix: ../../../
:mrdocs:

Append a new group of the specified `records` measuring the specified `elapsedTime`.

== Synopsis

Declared in `<balm_metricsample.h>`

[source,cpp,subs="verbatim,replacements,macros,-callouts"]
----
void
appendGroup(
    xref:BloombergLP/balm/MetricRecord.adoc[MetricRecord] const* records,
    int numRecords,
    xref:BloombergLP/bsls/TimeInterval.adoc[bsls::TimeInterval] const& elapsedTime);
----

== Description

Append to the sequence of groups maintained by this sample a new group containing the specified sequence of `records` of specified length `numRecords` measuring the specified `elapsedTime`. The behavior is undefined unless `0 <= numRecords`, `records` refers to a contiguous sequence of size (at least) `numRecords`, and `elapsedTime > bsls::TimeInterval(0, 0)`. Note that `records` is _not_ copied: hence, the supplied array must remain valid for the lifetime of this object or until the records are removed by calling `removeAllRecords()`. This method is functionally equivalent to: ` appendGroup(MetricSampleGroup(records, numRecords, elapsedTime)); `

== Parameters

[cols="1,4"]
|===
| Name| Description
| *records*
| contiguous sequence of metric records (held, not owned)
| *numRecords*
| number of records in `records`
| *elapsedTime*
| duration over which the records were collected
|===


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