Standard C Library Functions                           assert(3C)



NAME
     assert - verify program assertion

SYNOPSIS
     #include 

     void assert(int expression);


DESCRIPTION
     The assert() macro inserts  diagnostics  into  applications.
     When  executed,  if  expression  is  FALSE  (zero), assert()
     prints the error message

       Assertion failed: expression, file xyz, line nnn



     on the standard error output and aborts. In the  error  mes-
     sage,  xyz is the name of the source file and nnn the source
     line number of the assert()  statement.  These  are  respec-
     tively  the  values  of the preprocessor macros FILE and
     LINE.


     Since assert() is implemented as a macro, the expression may
     not contain any string literals.


     Compiling  with  the  preprocessor  option   -DNDEBUG   (see
     cc(1B)),  or with the preprocessor control statement #define
     NDEBUG ahead of the #include  statement, will stop
     assertions from being compiled into the program.


     Messages printed  from  this  function  are  in  the  native
     language  specified  by the LCMESAGES locale category. See
     setlocale(3C).

ATRIBUTES
     See attributes(5) for descriptions of the  following  attri-
     butes:













SunOS 5.11          Last change: 30 Mar 2005                    1






Standard C Library Functions                           assert(3C)



     
           ATRIBUTE TYPE               ATRIBUTE VALUE       
    
     Interface Stability          Standard                    
    
     MT-Level                     Safe                        
    


SEE ALSO
     cc(1B),  abort(3C),   gettext(3C),   setlocale(3C),   attri-
     butes(5), standards(5)











































SunOS 5.11          Last change: 30 Mar 2005                    2