[#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`&period;

== Synopsis

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

[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`&period; The behavior is undefined unless `0 &lt;&equals; numRecords`, `records` refers to a contiguous sequence of size (at least) `numRecords`, and `elapsedTime &gt; bsls&colon;&colon;TimeInterval(0, 0)`&period; Note that `records` is _not_ copied&colon; hence, the supplied array must remain valid for the lifetime of this object or until the records are removed by calling `removeAllRecords()`&period; This method is functionally equivalent to&colon; &grave; appendGroup(MetricSampleGroup(records, numRecords, elapsedTime))&semi; &grave;

== 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]#
