[#BloombergLP-balst-StackTrace]
= xref:BloombergLP.adoc[BloombergLP]::xref:BloombergLP/balst.adoc[balst]::StackTrace
:relfileprefix: ../../
:mrdocs:

This value‐semantic class describes a function‐call stack.

== Synopsis

Declared in `<balst_stacktrace.h>`

[source,cpp,subs="verbatim,replacements,macros,-callouts"]
----
class StackTrace;
----

== Description

A `StackTrace` is represented as a sequence of randomly accessible `StackTraceFrame` objects, each of which represents one function call on the stack. Note that if no allocator is supplied at construction, an owned `bdlma::HeapBypassAllocator` object is used to supply memory.

== Member Functions

[cols="1,4"]
|===
| Name| Description
| xref:BloombergLP/balst/StackTrace/2constructor-0c.adoc[`StackTrace`]         [.small]#[constructor]#
| Constructors
| xref:BloombergLP/balst/StackTrace/operator_assign.adoc[`operator=`] 
| Assign to this object the value of the specified `rhs` object, and return a reference providing modifiable access to this object.
| xref:BloombergLP/balst/StackTrace/allocator.adoc[`allocator`] 
| Return the allocator used by this object to supply memory. Note that if no allocator was supplied at construction the owned heap‐bypass allocator is used.
| xref:BloombergLP/balst/StackTrace/append.adoc[`append`] 
| Append to this sequence the specified `value`.
| xref:BloombergLP/balst/StackTrace/length.adoc[`length`] 
| Return the number of stack‐trace frames contained in this object.
| xref:BloombergLP/balst/StackTrace/operator_subs-0f.adoc[`operator[]`] 
| Subscript operators
| xref:BloombergLP/balst/StackTrace/print.adoc[`print`] 
| Format this object to the specified output `stream`.
| xref:BloombergLP/balst/StackTrace/removeAll.adoc[`removeAll`] 
| Remove all stack‐trace frames from this object. After this operation, the `length()` method will return 0.
| xref:BloombergLP/balst/StackTrace/resize.adoc[`resize`] 
| Resize this stack‐trace so that `length() == newLength`.
| xref:BloombergLP/balst/StackTrace/swap.adoc[`swap`] 
| Efficiently exchange the value of this object with the value of the specified `other` object.
| xref:BloombergLP/balst/StackTrace/2conversion.adoc[`operator BloombergLP::bslmf::NestedTraitDeclaration<StackTrace, IsBitwiseMoveable>`] 
| Nested trait declaration for `bslma::UsesBslmaAllocator`.
|===


== Friends

[cols="1,4"]
|===
| Name| Description
| `xref:BloombergLP/balst/operator_eq-0b.adoc[BloombergLP::balst::operator==]`
| Return `true` if the specified `lhs` and `rhs` objects have the same value, and `false` otherwise.
|===

== Non-Member Functions

[cols="1,4"]
|===
| Name| Description
| xref:BloombergLP/balst/operator_not_eq-08d.adoc[`operator!=`]
| Return `true` if the specified `lhs` and `rhs` objects do not have the same value, and `false` otherwise.
| xref:BloombergLP/balst/swap-033.adoc[`swap`]
| Exchange the values of the specified `a` and `b` objects.
|===


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