Format Bloomberg "cheapstack" contents into the specified buffer.

Synopsis

Declared in <bsls_stackaddressutil.h>

static
void
formatCheapStack(
    char* output,
    int length,
    char const* taskname = 0);

Description

Load the specified output buffer having the specified length with the Bloomberg standard "cheapstack" contents as a null‐terminated string. On successfully obtaining the current call stack, this will be instructions on how to run the Bloomberg tool showfunc.tsk (with the optionally specified taskname, otherwise with an attempt to obtain the system‐specific process name) to get details of the current call stack where formatCheapStack was called. On failure, text indicating that the call stack was not obtainable will be written to output. If length is not long enough for the entire output it will be truncated. The behavior is undefined unless 0 <= length and output has the capacity for at least length bytes.

Parameters

Name

Description

output

buffer to receive the null‐terminated cheapstack text

length

capacity of output in bytes

taskname

optional process or binary name for showfunc.tsk

Created with MrDocs