ASSERTMSG (Compact 2013)

  • Article

3/28/2014

This macro asserts an expression, and if that expression is FALSE, it prints a debugging message to NKDbgPrintfW and produces a DebugBreak.

Syntax

#define ASSERTMSG(
    message,
    Condition
)

Parameters

  • Message
    Formatted debugging message.
  • Condition
    Boolean value used to determine whether DEBUGMSG and DEBUGCHK are invoked.

Return Value

None.

Remarks

This macro may be used to check the value of a Boolean expression and produce a formatted text message, as well as generating a DebugBreak if the expression evaluates FALSE.

If the expression evaluates to FALSE, this code will print your failure message and then DebugBreak to allow you to examine the situation in a debugger. This macro also prints a debug message with the file name and line number where the assertion failed.

Call this macro to validate invariants in your code. For example, the following command

 ASSERTMSG(TEXT("Invalid number of items"),
           dwCurrentNumberOfItems < dwMaxNumberOfItems);

Will print output like this:

 Invalid number of items
 Unknown: DEBUGCHK failed in file C:\WINCE800\Programs\MyProgram\.\main.c at line 34

This macro is only present in Debug and Checked builds; it does nothing on Retail and Ship builds.

To evaluate an assertion without printing an additional message, use ASSERT.

Requirements

Header

dbgapi.h

See Also

Reference

Debugging Macros
ASSERT
DEBUGMSG
DebugBreak