[#BloombergLP-balst-StackTraceTestAllocator-2constructor-08]
= xref:BloombergLP.adoc[BloombergLP]::xref:BloombergLP/balst.adoc[balst]::xref:BloombergLP/balst/StackTraceTestAllocator.adoc[StackTraceTestAllocator]::StackTraceTestAllocator
:relfileprefix: ../../../
:mrdocs:

Create a test allocator. Optionally specify `numRecordedFrames`, the number of stack trace frame pointers to be saved for every allocation. Specifying a larger value of `numRecordedFrames` means that stack traces, when given, will be more complete, but will also mean that both more CPU time and more memory per allocation will be consumed. If `numRecordedFrames` is not specified, a value of `12` will be assumed. Optionally specify `basicAllocator`, the allocator from which memory will be provided. If `basicAllocator` is 0, the `MallocFreeAllocator` singleton is used. Associate `bsl::cerr` with this object for error diagnostic output, which may be changed by calling the `setOstream` manipulator. Set the `demanglingPreferringFlag` attribute to `true`, which may be changed using the `setDemanglingPreferredFlag` manipulator. The behavior is undefined if `numRecordedFrames < 2`.

== Synopsis

Declared in `<balst_stacktracetestallocator.h>`

[source,cpp,subs="verbatim,replacements,macros,-callouts"]
----
explicit
StackTraceTestAllocator(xref:BloombergLP/bslma/Allocator.adoc[bslma::Allocator]* basicAllocator = 0);
----


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