Amebis/wxWidgets
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

removed @NULL,@true,@false tags from the function prototypes; fixed * and & displacing in the prototypes; changed @param as discussed on wx-dev; use @see instead of @sa; better indentation for @returns,@remarks,@see paragraphs; other misc fixes

Browse Source 
git-svn-id: https://svn.wxwidgets.org/svn/wx/wxWidgets/trunk@52407 c3d73ce0-8a6f-49c7-b76d-6d57e0e08775
This commit is contained in:
Francesco Montorsi
2008-03-09 12:33:59 +00:00
parent 0aaf0255e4
commit 4cc4bfafe5
256 changed files with 8880 additions and 10701 deletions
Download Patch File Download Diff File Expand all files Collapse all files

65
interface/debug.h
View File

@@ -8,33 +8,30 @@
/**
Will always generate an assert error if this code is reached (in debug mode).
See also: wxFAIL_MSG
*/
#define wxFAIL() /* implementation is private */
wxFAIL();
/**
This function is called whenever one of debugging macros fails (i.e. condition
is @false in an assertion). It is only defined in the debug mode, in release
builds the wxCHECK failures don't result in anything.
To override the default behaviour in the debug builds which is to show the user
a dialog asking whether he wants to abort the program, continue or continue
ignoring any subsequent assert failures, you may override
wxApp::OnAssertFailure which is called by this function if
the global application object exists.
*/
void wxOnAssert(const char * fileName, int lineNumber,
const char * func,
const char * cond,
const char * msg = @NULL);
void wxOnAssert(const char* fileName, int lineNumber,
const char* func,
const char* cond,
const char* msg = NULL);
/**
In debug mode (when @c __WXDEBUG__ is defined) this function generates a
debugger exception meaning that the control is passed to the debugger if one is
attached to the process. Otherwise the program just terminates abnormally.
In release mode this function does nothing.
*/
void wxTrap();
@@ -42,12 +39,11 @@ void wxTrap();
/**
Will always generate an assert error with specified message if this code is
reached (in debug mode).
This macro is useful for marking unreachable" code areas, for example
it may be used in the "default:" branch of a switch statement if all possible
cases are processed above.
@sa wxFAIL
@see wxFAIL
*/
#define wxFAIL_MSG(msg) /* implementation is private */
@@ -56,14 +52,14 @@ void wxTrap();
(FAILs in debug mode).
This check is done even in release mode.
*/
#define wxCHECK(condition, retValue) /* implementation is private */
#define wxCHECK(condition, retValue) /* implementation is private */
/**
This macro results in a
@ref overview_wxcompiletimeassert "compile time assertion failure" if the size
of the given type @e type is less than @e size bits.
of the given type @a type is less than @a size bits.
You may use it like this, for example:
@code
// we rely on the int being able to hold values up to 2^32
wxASSERT_MIN_BITSIZE(int, 32);
@@ -72,93 +68,86 @@ void wxTrap();
wxASSERT_MIN_BITSIZE(wchar_t, 16);
@endcode
*/
#define wxASSERT_MIN_BITSIZE(type, size) /* implementation is private */
#define wxASSERT_MIN_BITSIZE(type, size) /* implementation is private */
/**
Assert macro with message. An error message will be generated if the condition
is @false.
@sa wxASSERT, wxCOMPILE_TIME_ASSERT
@see wxASSERT, wxCOMPILE_TIME_ASSERT
*/
#define wxASSERT_MSG(condition, msg) /* implementation is private */
#define wxASSERT_MSG(condition, msg) /* implementation is private */
/**
This is the same as wxCHECK2, but
wxFAIL_MSG with the specified @e msg is called
instead of wxFAIL() if the @e condition is @false.
wxFAIL_MSG with the specified @a msg is called
instead of wxFAIL() if the @a condition is @false.
*/
#define wxCHECK2(condition, operation, msg) /* implementation is private */
#define wxCHECK2(condition, operation, msg) /* implementation is private */
/**
Assert macro. An error message will be generated if the condition is @false in
debug mode, but nothing will be done in the release build.
Please note that the condition in wxASSERT() should have no side effects
because it will not be executed in release mode at all.
@sa wxASSERT_MSG, wxCOMPILE_TIME_ASSERT
@see wxASSERT_MSG, wxCOMPILE_TIME_ASSERT
*/
#define wxASSERT(condition) /* implementation is private */
/**
Checks that the condition is @true, and returns if not (FAILs with given error
message in debug mode). This check is done even in release mode.
This macro should be used in void functions instead of
wxCHECK_MSG.
*/
#define wxCHECK_RET(condition, msg) /* implementation is private */
#define wxCHECK_RET(condition, msg) /* implementation is private */
/**
Checks that the condition is @true and wxFAIL and execute
@e operation if it is not. This is a generalisation of
@a operation if it is not. This is a generalisation of
wxCHECK and may be used when something else than just
returning from the function must be done when the @e condition is @false.
returning from the function must be done when the @a condition is @false.
This check is done even in release mode.
*/
#define wxCHECK2(condition, operation) /* implementation is private */
#define wxCHECK2(condition, operation) /* implementation is private */
/**
This macro is identical to wxCOMPILE_TIME_ASSERT2
except that it allows you to specify a unique @e name for the struct
except that it allows you to specify a unique @a name for the struct
internally defined by this macro to avoid getting the compilation errors
described above.
*/
#define wxCOMPILE_TIME_ASSERT(condition, msg, name) /* implementation is private */
#define wxCOMPILE_TIME_ASSERT(condition, msg, name) /* implementation is private */
/**
Checks that the condition is @true, returns with the given return value if not
(FAILs in debug mode).
This check is done even in release mode.
This macro may be only used in non-void functions, see also
wxCHECK_RET.
*/
#define wxCHECK_MSG(condition, retValue, msg) /* implementation is private */
#define wxCHECK_MSG(condition, retValue, msg) /* implementation is private */
/**
Using @c wxCOMPILE_TIME_ASSERT results in a compilation error if the
specified @e condition is @false. The compiler error message should include
the @e msg identifier - please note that it must be a valid C++ identifier
specified @a condition is @false. The compiler error message should include
the @a msg identifier - please note that it must be a valid C++ identifier
and not a string unlike in the other cases.
This macro is mostly useful for testing the expressions involving the
@c sizeof operator as they can't be tested by the preprocessor but it is
sometimes desirable to test them at the compile time.
Note that this macro internally declares a struct whose name it tries to make
unique by using the @c __LINE__ in it but it may still not work if you
use it on the same line in two different source files. In this case you may
either change the line in which either of them appears on or use the
wxCOMPILE_TIME_ASSERT2 macro.
Also note that Microsoft Visual C++ has a bug which results in compiler errors
if you use this macro with 'Program Database For Edit And Continue'
(@c /ZI) option, so you shouldn't use it ('Program Database'
(@c /Zi) is ok though) for the code making use of this macro.
@sa wxASSERT_MSG, wxASSERT_MIN_BITSIZE
@see wxASSERT_MSG, wxASSERT_MIN_BITSIZE
*/
#define wxCOMPILE_TIME_ASSERT(condition, msg) /* implementation is private */
#define wxCOMPILE_TIME_ASSERT(condition, msg) /* implementation is private */