ASSERT (Compact 2013)

  • Article

3/28/2014

This macro asserts an expression and produces a DebugBreak if the expression is FALSE.

Syntax

#define ASSERT(exp)

Parameters

  • Exp
    A Boolean expression used to determine when a DebugBreak is called.

Return Value

None.

Remarks

This macro may be used to check the value of a Boolean expression and produce a DebugBreak if the expression evaluates FALSE. 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:

 ASSERT(dwCurrentNumberOfItems < dwMaxNumberOfItems);

Will print output like this:

 Unknown: DEBUGCHK failed in file C:\WINCE800\Programs\MyProgram\.\main.c at line 32

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

The ASSERT macro does not assume that dpCurSettings is present. Use ASSERT within modules that do not define dpCurSettings, and DEBUGCHK within modules that do define dpCurSettings.

To print an additional string whenever your assertion fails, use ASSERTMSG.

Requirements

Header

dbgapi.h

See Also

Reference

Debugging Macros
DEBUGCHK
DBGPARAM
DebugBreak