Moved all interface headers into a 'wx' subdirectory for proper use of Doxygen path settings.
git-svn-id: https://svn.wxwidgets.org/svn/wx/wxWidgets/trunk@54385 c3d73ce0-8a6f-49c7-b76d-6d57e0e08775
This commit is contained in:
Bryan Petty
295
interface/wx/memory.h
Normal file
295
interface/wx/memory.h
Normal file
@@ -0,0 +1,295 @@
|
||||
/////////////////////////////////////////////////////////////////////////////
|
||||
// Name: memory.h
|
||||
// Purpose: interface of wxDebugStreamBuf
|
||||
// Author: wxWidgets team
|
||||
// RCS-ID: $Id$
|
||||
// Licence: wxWindows license
|
||||
/////////////////////////////////////////////////////////////////////////////
|
||||
|
||||
/**
|
||||
@class wxDebugStreamBuf
|
||||
@wxheader{memory.h}
|
||||
|
||||
This class allows you to treat debugging output in a similar
|
||||
(stream-based) fashion on different platforms. Under
|
||||
Windows, an ostream constructed with this buffer outputs
|
||||
to the debugger, or other program that intercepts debugging
|
||||
output. On other platforms, the output goes to standard error (cerr).
|
||||
|
||||
This is soon to be obsolete, replaced by wxLog functionality.
|
||||
|
||||
@library{wxbase}
|
||||
@category{FIXME}
|
||||
|
||||
@see Overview()
|
||||
*/
|
||||
class wxDebugStreamBuf
|
||||
{
|
||||
public:
|
||||
|
||||
};
|
||||
|
||||
|
||||
|
||||
/**
|
||||
@class wxDebugContext
|
||||
@wxheader{memory.h}
|
||||
|
||||
A class for performing various debugging and memory tracing
|
||||
operations. Full functionality (such as printing out objects
|
||||
currently allocated) is only present in a debugging build of wxWidgets,
|
||||
i.e. if the __WXDEBUG__ symbol is defined. wxDebugContext
|
||||
and related functions and macros can be compiled out by setting
|
||||
wxUSE_DEBUG_CONTEXT to 0 is setup.h
|
||||
|
||||
@library{wxbase}
|
||||
@category{debugging}
|
||||
|
||||
@see Overview()
|
||||
*/
|
||||
class wxDebugContext
|
||||
{
|
||||
public:
|
||||
/**
|
||||
Checks the memory blocks for errors, starting from the currently set
|
||||
checkpoint.
|
||||
|
||||
@return Returns the number of errors, so a value of zero represents
|
||||
success. Returns -1 if an error was detected that
|
||||
prevents further checking.
|
||||
*/
|
||||
int Check();
|
||||
|
||||
/**
|
||||
Performs a memory dump from the currently set checkpoint, writing to the
|
||||
current debug stream. Calls the @b Dump member function for each wxObject
|
||||
derived instance.
|
||||
|
||||
@return @true if the function succeeded, @false otherwise.
|
||||
*/
|
||||
bool Dump();
|
||||
|
||||
/**
|
||||
Returns @true if the memory allocator checks all previous memory blocks for
|
||||
errors.
|
||||
By default, this is @false since it slows down execution considerably.
|
||||
|
||||
@see SetCheckPrevious()
|
||||
*/
|
||||
bool GetCheckPrevious();
|
||||
|
||||
/**
|
||||
Returns @true if debug mode is on. If debug mode is on, the wxObject new and
|
||||
delete
|
||||
operators store or use information about memory allocation. Otherwise,
|
||||
a straight malloc and free will be performed by these operators.
|
||||
|
||||
@see SetDebugMode()
|
||||
*/
|
||||
bool GetDebugMode();
|
||||
|
||||
/**
|
||||
Gets the debug level (default 1). The debug level is used by the wxTraceLevel
|
||||
function and
|
||||
the WXTRACELEVEL macro to specify how detailed the trace information is; setting
|
||||
a different level will only have an effect if trace statements in the
|
||||
application
|
||||
specify a value other than one.
|
||||
This is obsolete, replaced by wxLog functionality.
|
||||
|
||||
@see SetLevel()
|
||||
*/
|
||||
int GetLevel();
|
||||
|
||||
/**
|
||||
Returns the output stream associated with the debug context.
|
||||
This is obsolete, replaced by wxLog functionality.
|
||||
|
||||
@see SetStream()
|
||||
*/
|
||||
ostream GetStream();
|
||||
|
||||
/**
|
||||
Returns a pointer to the output stream buffer associated with the debug context.
|
||||
There may not necessarily be a stream buffer if the stream has been set
|
||||
by the user.
|
||||
This is obsolete, replaced by wxLog functionality.
|
||||
*/
|
||||
streambuf* GetStreamBuf();
|
||||
|
||||
/**
|
||||
Returns @true if there is a stream currently associated
|
||||
with the debug context.
|
||||
This is obsolete, replaced by wxLog functionality.
|
||||
|
||||
@see SetStream(), GetStream()
|
||||
*/
|
||||
bool HasStream();
|
||||
|
||||
/**
|
||||
Prints a list of the classes declared in this application, giving derivation
|
||||
and whether instances of this class can be dynamically created.
|
||||
|
||||
@see PrintStatistics()
|
||||
*/
|
||||
bool PrintClasses();
|
||||
|
||||
/**
|
||||
Performs a statistics analysis from the currently set checkpoint, writing
|
||||
to the current debug stream. The number of object and non-object
|
||||
allocations is printed, together with the total size.
|
||||
|
||||
@param detailed
|
||||
If @true, the function will also print how many
|
||||
objects of each class have been allocated, and the space taken by
|
||||
these class instances.
|
||||
|
||||
@see PrintStatistics()
|
||||
*/
|
||||
bool PrintStatistics(bool detailed = true);
|
||||
|
||||
/**
|
||||
Tells the memory allocator to check all previous memory blocks for errors.
|
||||
By default, this is @false since it slows down execution considerably.
|
||||
|
||||
@see GetCheckPrevious()
|
||||
*/
|
||||
void SetCheckPrevious(bool check);
|
||||
|
||||
/**
|
||||
Sets the current checkpoint: Dump and PrintStatistics operations will
|
||||
be performed from this point on. This allows you to ignore allocations
|
||||
that have been performed up to this point.
|
||||
|
||||
@param all
|
||||
If @true, the checkpoint is reset to include all
|
||||
memory allocations since the program started.
|
||||
*/
|
||||
void SetCheckpoint(bool all = false);
|
||||
|
||||
/**
|
||||
Sets the debug mode on or off. If debug mode is on, the wxObject new and delete
|
||||
operators store or use information about memory allocation. Otherwise,
|
||||
a straight malloc and free will be performed by these operators.
|
||||
By default, debug mode is on if __WXDEBUG__ is defined. If the application
|
||||
uses this function, it should make sure that all object memory allocated
|
||||
is deallocated with the same value of debug mode. Otherwise, the
|
||||
delete operator might try to look for memory information that does not
|
||||
exist.
|
||||
|
||||
@see GetDebugMode()
|
||||
*/
|
||||
void SetDebugMode(bool debug);
|
||||
|
||||
/**
|
||||
Sets the current debug file and creates a stream. This will delete any existing
|
||||
stream and stream buffer. By default, the debug context stream
|
||||
outputs to the debugger (Windows) or standard error (other platforms).
|
||||
*/
|
||||
bool SetFile(const wxString& filename);
|
||||
|
||||
/**
|
||||
Sets the debug level (default 1). The debug level is used by the wxTraceLevel
|
||||
function and
|
||||
the WXTRACELEVEL macro to specify how detailed the trace information is; setting
|
||||
a different level will only have an effect if trace statements in the
|
||||
application
|
||||
specify a value other than one.
|
||||
This is obsolete, replaced by wxLog functionality.
|
||||
|
||||
@see GetLevel()
|
||||
*/
|
||||
void SetLevel(int level);
|
||||
|
||||
/**
|
||||
Installs a function to be called at the end of wxWidgets shutdown. It will be
|
||||
called after
|
||||
all files with global instances of wxDebugContextDumpDelayCounter have run
|
||||
their destructors.
|
||||
The shutdown function must be take no parameters and return nothing.
|
||||
*/
|
||||
void SetShutdownNotifyFunction(wxShutdownNotifyFunction func);
|
||||
|
||||
/**
|
||||
Sets the debugging stream to be the debugger (Windows) or standard error (other
|
||||
platforms).
|
||||
This is the default setting. The existing stream will be flushed and deleted.
|
||||
This is obsolete, replaced by wxLog functionality.
|
||||
*/
|
||||
bool SetStandardError();
|
||||
|
||||
/**
|
||||
Sets the stream and optionally, stream buffer associated with the debug context.
|
||||
This operation flushes and deletes the existing stream (and stream buffer if
|
||||
any).
|
||||
This is obsolete, replaced by wxLog functionality.
|
||||
|
||||
@param stream
|
||||
Stream to associate with the debug context. Do not set this to @NULL.
|
||||
@param streamBuf
|
||||
Stream buffer to associate with the debug context.
|
||||
*/
|
||||
void SetStream(ostream* stream, streambuf* streamBuf = NULL);
|
||||
};
|
||||
|
||||
|
||||
|
||||
// ============================================================================
|
||||
// Global functions/macros
|
||||
// ============================================================================
|
||||
|
||||
/** @ingroup group_funcmacro_log */
|
||||
//@{
|
||||
|
||||
/**
|
||||
@deprecated Use one of the wxLogTrace() functions or one of the
|
||||
wxVLogTrace() functions instead.
|
||||
|
||||
Calls wxTrace() with printf-style variable argument syntax. Output is
|
||||
directed to the current output stream (see wxDebugContext).
|
||||
|
||||
@header{wx/memory.h}
|
||||
*/
|
||||
#define WXTRACE(format, ...)
|
||||
|
||||
/**
|
||||
@deprecated Use one of the wxLogTrace() functions or one of the
|
||||
wxVLogTrace() functions instead.
|
||||
|
||||
Calls wxTraceLevel with printf-style variable argument syntax. Output is
|
||||
directed to the current output stream (see wxDebugContext). The first
|
||||
argument should be the level at which this information is appropriate. It
|
||||
will only be output if the level returned by wxDebugContext::GetLevel is
|
||||
equal to or greater than this value.
|
||||
|
||||
@header{wx/memory.h}
|
||||
*/
|
||||
#define WXTRACELEVEL(level, format, ...)
|
||||
|
||||
/**
|
||||
@deprecated Use one of the wxLogTrace() functions or one of the
|
||||
wxVLogTrace() functions instead.
|
||||
|
||||
Takes printf-style variable argument syntax. Output is directed to the
|
||||
current output stream (see wxDebugContext).
|
||||
|
||||
@header{wx/memory.h}
|
||||
*/
|
||||
void wxTrace(const wxString& format, ...);
|
||||
|
||||
/**
|
||||
@deprecated Use one of the wxLogTrace() functions or one of the
|
||||
wxVLogTrace() functions instead.
|
||||
|
||||
Takes @e printf() style variable argument syntax. Output is directed to the
|
||||
current output stream (see wxDebugContext). The first argument should be
|
||||
the level at which this information is appropriate. It will only be output
|
||||
if the level returned by wxDebugContext::GetLevel() is equal to or greater
|
||||
than this value.
|
||||
|
||||
@header{wx/memory.h}
|
||||
*/
|
||||
void wxTraceLevel(int level, const wxString& format, ...);
|
||||
|
||||
//@}
|
||||
|
||||
Reference in New Issue
Block a user