assert(3) [mojave man page]

ASSERT(3)						   BSD Library Functions Manual 						 ASSERT(3)

NAME

     assert -- expression verification macro

SYNOPSIS

     #include <assert.h>

     assert(expression);

DESCRIPTION

     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 abort(3) function is called, effectively terminating the program.

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

     The assert() macro may be removed at compile time with the cc(1) option -DNDEBUG.

DIAGNOSTICS

     The following diagnostic message is written to stderr if expression is false:

	   "assertion "%s" failed: file "%s", line %d
", 
			       "expression", __FILE__, __LINE__);

SEE ALSO

     cc(1), abort(3)

STANDARDS

     The assert() macro conforms to ANSI X3.159-1989 (``ANSI C89'').

HISTORY

     A assert macro appeared in Version 6 AT&T UNIX.

BSD
								   June 9, 1993 							       BSD

assert(3)						     Library Functions Manual							 assert(3)

NAME

       assert - Inserts program diagnostics

LIBRARY

       Standard C Library (libc.a, libc.so)

SYNOPSIS

       #include <assert.h>

       void assert(
	   int expression) ;

STANDARDS

       Interfaces documented on this reference page conform to industry standards as follows:

       assert():  XPG4, XPG4-UNIX

       Refer to the standards(5) reference page for more information about industry standards and associated tags.

PARAMETERS

       Specifies  an  expression  that	is  evaluated as TRUE or FALSE. This expression is evaluated in the same manner as a C language if control
       statement.

DESCRIPTION

       The assert() macro inserts diagnostics into programs.  On execution, when the expression parameter is false  (returns  FALSE),  this  macro
       writes  information about the particular call that failed, including the text of the argument, the name of the source file, and the source-
       file line number (the latter two are respectively the values of preprocessing macros __FILE__ and __LINE__) on stderr.  The  error  message
       is  taken  from	the  standard  C  library  message catalog. The assert() macro then calls the abort() function to (normally) terminate the
       process.

       When you compile a program with the -DNDEBUG preprocessor option, or with the #define NDEBUG  preprocessor  control  statement  before  the
       #include <assert.h> statement, calls to the assert() macro have no effect.

RETURN VALUES

       The assert() function returns no value.

RELATED INFORMATION

       Routines: abort(3)

       Standards: standards(5) delim off

																	 assert(3)