This header defines the C++ wrapper class for the callstack structure.
It's not necessary to include this header on its own, this is automatically done by callstack.h.

The namespace used to separate the wrapper class from the struct callstack, declared in callstack.h.

The actual wrapper class, consisting of all necessary operators and constructors for seamlessly integration into C++ code.

A typedef to improve the readability of the code.

A private variable containing the underlying struct callstack.

The default constructor. Creates a new backtrace unless emplace is set to false. In either case, the underlying struct callstack is properly initialized.
If the backtrace could not be created a runtime_error or a system_error if compiled using C++11 or newer is thrown.

Initializes the underlying struct callstack creating a backtrace of the calling function, ignoring all frames after the given address.
If the backtrace could not be created a runtime_error or a system_error if compiled using C++11 or newer is thrown.

Constructs the underlying struct callstack using the given trace.
If the length of the trace is smaller than 0 a runtime_error or a system_error if compiled using C++11 or newer is thrown.

Trivial copy constructor.

Constructs a callstack object using the given struct callstack.

Trivial move constructor. Only available when compiled using a compiler supporting C++11 or newer.

Trivial destructor.

Trivial copy assignment operator.

Trivial move assignment operator. Only available when compiled using a compiler supporting C++11 or newer.

Implicit casting operator. Returns a pointer to the underlying struct callstack.

Implicit casting operator. Returns a pointer to the underlying struct callstack.

Dereferencing operator. Returns a pointer to the underlying struct callstack.

Dereferencing operator. Returns a pointer to the underlying struct callstack.

Private helper function used to throw either a system_error if compiled using C++11 or newer or to throw a runtime_error otherwise.

Translates the callstack object.
If desired, only the runtime image names are deducted.

Throws an exception if the translation failed.

Relativizes the callstack object. For each frame, the name of the binary file is placed into the given array, and the address of the callstack frame is relative to its binary file.
This operation can be undone by using the method absolutize().

Relativizes the callstack object. For each frame, the name of the binary file is placed into an array, which is then returned. Afterward, the address of each callstack frame is relative to its binary file.
This operation can be undone by using the method absolutize().

This method is only available when using a compiler compatible with C++11 or newer.

Absolutizes and translates the callstack object. Each frame is absolutized by using the indicated binary file name. The given array of binary file names must at least contain as much file names as callstack frames of the callstack object.
The translated callstack frame array is returned.

Returns a pointer to the first callstack frame in the translated callstack frame array.
This pointer can be used as begin iterator.

Returns a pointer past the last callstack frame in the translated callstack frame array.
This pointer can be used as (past the) end iterator.