AVR Libc Home Page |  | AVR Libc Development Pages
Main Page | User Manual | Library Reference | FAQ | Alphabetical Index | Example Projects

# <assert.h>: Diagnostics

## Defines
#define | assert(expression)

## Detailed Description

     #include <assert.h>

This header file defines a debugging aid.

As there is no standard error output stream available for many applications using this library, the generation of a printable error message is not enabled by default. These messages will only be generated if the application defines the macro

     __ASSERT_USE_STDERR

before including the `<assert.h>` header file. By default, only abort() will be called to halt the application.

## Define Documentation

#define assert | ( | expression |  | ) |

Parameters:

  | expression | Expression to test for.

The assert() macro tests the given expression and if it is false, the calling process is terminated. A diagnostic message is written to stderr and the function abort() is called, effectively terminating the program.

If expression is true, the assert() macro does nothing.

The assert() macro may be removed at compile time by defining NDEBUG as a macro (e.g., by using the compiler option -DNDEBUG).

Automatically generated by Doxygen 1.5.7 on 6 Nov 2008.