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

`appendGroup` overloads

== Synopses

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

Append the specified `group` of records to the sequence of groups maintained by this sample&period; If `group&period;numRecords()` is 0 this method has no effect&period; The behavior is undefined unless `group&period;elapsedTime() &gt; bsls&colon;&colon;TimeInterval(0, 0)`&period; Note that the `MetricRecord` objects referred to by `records` are _not_ copied&colon; hence, the supplied array must remain valid for the productive lifetime of this object or until the group is removed by calling `removeAllRecords()`&period;


[source,cpp,subs="verbatim,replacements,macros,-callouts"]
----
void
xref:BloombergLP/balm/MetricSample/appendGroup-05.adoc[appendGroup](xref:BloombergLP/balm/MetricSampleGroup.adoc[MetricSampleGroup] const& group);
----

[.small]#xref:BloombergLP/balm/MetricSample/appendGroup-05.adoc[_» more&period;&period;&period;_]#

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;


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

[.small]#xref:BloombergLP/balm/MetricSample/appendGroup-00.adoc[_» more&period;&period;&period;_]#


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