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

Append the specified `group` of records to the sequence of groups maintained by this sample&period;

== Synopsis

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

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

== Description

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;

== Parameters

[cols="1,4"]
|===
| Name| Description
| *group*
| sample group to append
|===


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