[#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 `<balm_metricsample.h>`

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


[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..._]#

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)); `


[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..._]#


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