HP-UX Reference (11i v1 00/12) - 3 Library Functions A-M (vol 6)

__________________________________________________________________________________________________________________________________________________________________________________________________
__________________________________________________________________________________________________________________________________________________________________________________________________
STANDARD Printed by: Nora Chuang [nchuang] STANDARD
/build/1111/BRICK/man3/!!!intro.3c
________________________________________________________________
___ ___
a
assert(3X) assert(3X)
NAME
assert() - verify program assertion
SYNOPSIS
#include <assert.h>
void assert(int expression);
DESCRIPTION
This macro is useful for putting diagnostics into programs. When it is executed, if expression is false (zero),
assert() prints:
Assertion failed: expression, file xyz, line nnn
on the standard error output and aborts. In the error message, xyz is the name of the source file and nnn
the source line number of the assert() statement.
Compiling with the preprocessor option -DNDEBUG (see cpp(1)), or with the preprocessor control state-
ment #define NDEBUG ahead of the #include <assert.h> statement, stops assertions from
being compiled into the program.
APPLICATION USAGE
assert() is thread-safe. It is not async-cancel-safe.
WARNINGS
The expression argument used by assert() in compatibility mode cannot contain string literals or dou-
ble quotes without escapes.
SEE ALSO
cpp(1), abort(3C).
STANDARDS CONFORMANCE
assert(): AES, SVID2, SVID3, XPG2, XPG3, XPG4, FIPS 151-2, POSIX.1, ANSI C
HP-UX Release 11i: December 2000 1 Section 323
___
___