Share via


ASSERT (Windows CE 5.0)

Send Feedback

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

#define ASSERT(exp)

Parameters

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

Return Values

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 code causes DebugBreak to allow you to examine the situation in a debugger if the expression evaluates to 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:\WINCE500\Programs\MyProgram\.\main.c at line 32

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

This 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

OS Versions: Windows CE OS 2.10 and later
Header: Dbgapi.h
Link Library: none

See Also

DEBUGCHK | DBGPARAM | DebugBreak

Send Feedback on this topic to the authors

Feedback FAQs

© 2006 Microsoft Corporation. All rights reserved.