wxstackframe

wxstackframe represents a single stack frame, or a single function in the call stack, and is used exclusively together with wxstackwalker, see there for a more detailed discussion.

derived from

no base class

include files

<wx/stackwalk.h>

only available if wxuse_stackwalker is 1, currently only implemented for win32 and unix versions using recent version of gnu libc.

see also

wxstackwalker

members

wxstackframe::getaddress
wxstackframe::getfilename
wxstackframe::getlevel
wxstackframe::getline
wxstackframe::getmodule
wxstackframe::getname
wxstackframe::getoffset
wxstackframe::getparam
wxstackframe::getparamcount
wxstackframe::hassourcelocation

wxstackframe::getaddress

void* getaddress() const

return the address of this frame.

wxstackframe::getfilename

wxstring getfilename() const

return the name of the file containing this frame, empty if unavailable (typically because debug info is missing).

use hassourcelocation to check whether the file name is available.

wxstackframe::getlevel

size_t getlevel() const

get the level of this frame (deepest/innermost one is 0).

wxstackframe::getline

size_t getline() const

return the line number of this frame, 0 if unavailable.

see also

getfilename

wxstackframe::getmodule

wxstring getmodule() const

get the module this function belongs to (empty if not available).

wxstackframe::getname

wxstring getname() const

return the unmangled (if possible) name of the function containing this frame.

wxstackframe::getoffset

size_t getoffset() const

return the return address of this frame.

wxstackframe::getparam

bool getparam(size_t n, wxstring * type, wxstring * name, wxstring * value) const

get the name, type and value (in text form) of the given parameter. any pointer may be null if you're not interested in the corresponding value.

return true if at least some values could be retrieved.

this function currently is only implemented under win32 and requires a pdb file.

wxstackframe::getparamcount

size_t getparamcount() const

return the number of parameters of this function (may return 0 if we can't retrieve the parameters info even although the function does have parameters).

wxstackframe::hassourcelocation

bool hassourcelocation() const

return true if we have the file name and line number for this frame.