2005-01-18 20:42:25 -05:00
|
|
|
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
|
|
|
|
%% Name: stackframe.tex
|
|
|
|
%% Purpose: wxStackFrame documentation
|
|
|
|
%% Author: Vadim Zeitlin
|
|
|
|
%% Created: 2005-01-19
|
|
|
|
%% RCS-ID: $Id$
|
|
|
|
%% Copyright: (c) 2005 Vadim Zeitlin
|
2005-02-22 10:09:56 -05:00
|
|
|
%% License: wxWindows license
|
2005-01-18 20:42:25 -05:00
|
|
|
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
|
|
|
|
|
|
|
|
\section{\class{wxStackFrame}}\label{wxstackframe}
|
|
|
|
|
|
|
|
|
|
|
|
wxStackFrame represents a single stack frame, or a single function in the call
|
|
|
|
stack, and is used exclusively together with
|
|
|
|
\helpref{wxStackWalker}{wxstackwalker}, see there for a more detailed
|
|
|
|
discussion.
|
|
|
|
|
|
|
|
|
|
|
|
\wxheading{Derived from}
|
|
|
|
|
|
|
|
No base class
|
|
|
|
|
|
|
|
\wxheading{Include files}
|
|
|
|
|
|
|
|
<wx/stackwalk.h>
|
|
|
|
|
2007-07-28 08:21:03 -04:00
|
|
|
\wxheading{Library}
|
|
|
|
|
|
|
|
\helpref{wxBase}{librarieslist}
|
|
|
|
|
2005-01-18 20:42:25 -05:00
|
|
|
Only available if \texttt{wxUSE\_STACKWALKER} is $1$, currently only
|
|
|
|
implemented for Win32 and Unix versions using recent version of GNU libc.
|
|
|
|
|
|
|
|
\wxheading{See also}
|
|
|
|
|
|
|
|
\helpref{wxStackWalker}{wxstackwalker}
|
|
|
|
|
|
|
|
|
|
|
|
\latexignore{\rtfignore{\wxheading{Members}}}
|
|
|
|
|
|
|
|
|
|
|
|
\membersection{wxStackFrame::GetAddress}\label{wxstackframegetaddress}
|
|
|
|
|
|
|
|
\constfunc{void*}{GetAddress}{\void}
|
|
|
|
|
|
|
|
Return the address of this frame.
|
|
|
|
|
|
|
|
|
|
|
|
\membersection{wxStackFrame::GetFileName}\label{wxstackframegetfilename}
|
|
|
|
|
|
|
|
\constfunc{wxString}{GetFileName}{\void}
|
|
|
|
|
|
|
|
Return the name of the file containing this frame, empty if
|
|
|
|
unavailable (typically because debug info is missing).
|
|
|
|
|
2005-01-20 10:50:06 -05:00
|
|
|
Use \helpref{HasSourceLocation}{wxstackframehassourcelocation} to check whether
|
2005-01-18 20:42:25 -05:00
|
|
|
the file name is available.
|
|
|
|
|
|
|
|
|
|
|
|
\membersection{wxStackFrame::GetLevel}\label{wxstackframegetlevel}
|
|
|
|
|
|
|
|
\constfunc{size\_t}{GetLevel}{\void}
|
|
|
|
|
|
|
|
Get the level of this frame (deepest/innermost one is $0$).
|
|
|
|
|
|
|
|
|
|
|
|
\membersection{wxStackFrame::GetLine}\label{wxstackframegetline}
|
|
|
|
|
|
|
|
\constfunc{size\_t}{GetLine}{\void}
|
|
|
|
|
|
|
|
Return the line number of this frame, $0$ if unavailable.
|
|
|
|
|
|
|
|
\wxheading{See also}
|
|
|
|
|
|
|
|
\helpref{GetFileName}{wxstackframegetfilename}
|
|
|
|
|
|
|
|
|
|
|
|
\membersection{wxStackFrame::GetModule}\label{wxstackframegetmodule}
|
|
|
|
|
|
|
|
\constfunc{wxString}{GetModule}{\void}
|
|
|
|
|
|
|
|
Get the module this function belongs to (empty if not available).
|
|
|
|
|
|
|
|
|
|
|
|
\membersection{wxStackFrame::GetName}\label{wxstackframegetname}
|
|
|
|
|
|
|
|
\constfunc{wxString}{GetName}{\void}
|
|
|
|
|
|
|
|
Return the unmangled (if possible) name of the function containing this
|
|
|
|
frame.
|
|
|
|
|
|
|
|
|
|
|
|
\membersection{wxStackFrame::GetOffset}\label{wxstackframegetoffset}
|
|
|
|
|
|
|
|
\constfunc{size\_t}{GetOffset}{\void}
|
|
|
|
|
|
|
|
Return the return address of this frame.
|
|
|
|
|
|
|
|
|
|
|
|
\membersection{wxStackFrame::GetParam}\label{wxstackframegetparam}
|
|
|
|
|
|
|
|
\constfunc{bool}{GetParam}{\param{size\_t }{n}, \param{wxString * }{type}, \param{wxString * }{name}, \param{wxString * }{value}}
|
|
|
|
|
|
|
|
Get the name, type and value (in text form) of the given parameter.
|
2005-01-20 10:50:06 -05:00
|
|
|
Any pointer may be \texttt{NULL} if you're not interested in the corresponding
|
2005-01-18 20:42:25 -05:00
|
|
|
value.
|
|
|
|
|
|
|
|
Return \true if at least some values could be retrieved.
|
|
|
|
|
|
|
|
This function currently is only implemented under Win32 and requires a PDB
|
|
|
|
file.
|
|
|
|
|
|
|
|
|
|
|
|
\membersection{wxStackFrame::GetParamCount}\label{wxstackframegetparamcount}
|
|
|
|
|
|
|
|
\constfunc{size\_t}{GetParamCount}{\void}
|
|
|
|
|
|
|
|
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).
|
|
|
|
|
|
|
|
|
|
|
|
\membersection{wxStackFrame::HasSourceLocation}\label{wxstackframehassourcelocation}
|
|
|
|
|
|
|
|
\constfunc{bool}{HasSourceLocation}{\void}
|
|
|
|
|
|
|
|
Return \true if we have the file name and line number for this frame.
|
|
|
|
|
|
|
|
|