Return to assert CVS log

Up to [MW Coherent from dump] / coherent / a / usr / man / ALL

Annotation of coherent/a/usr/man/ALL/assert, revision 1.1

1.1     ! root        1: 
        !             2: 
        !             3: assert()                      Macro                      assert()
        !             4: 
        !             5: 
        !             6: 
        !             7: 
        !             8: Check assertion at run time
        !             9: 
        !            10: #include <assert.h>
        !            11: vvooiidd aasssseerrtt(_e_x_p_r_e_s_s_i_o_n) iinntt _e_x_p_r_e_s_s_i_o_n;
        !            12: 
        !            13: assert checks  the value of  expression.  If expression  is false
        !            14: (zero), assert sends a message into the standard-error stream and
        !            15: calls exit.   It is  useful for  verifying that a  necessary con-
        !            16: dition is true.
        !            17: 
        !            18: The error message includes the text of the assertion that failed,
        !            19: the name of the source file,  and the line within the source file
        !            20: that holds  the expression in question.   These last two elements
        !            21: consist, respectively,  of the values of  the preprocessor macros
        !            22: _ _FILE_ _ and _ _LINE_ _.
        !            23: 
        !            24: assert calls exit, which never returns.
        !            25: 
        !            26: To turn  off assert, define  the macro NDEBUG  prior to including
        !            27: the header assert.h.  This forces assert to be redefined as
        !            28: 
        !            29: 
        !            30:         #define assert(ignore)
        !            31: 
        !            32: 
        !            33: ***** See Also *****
        !            34: 
        !            35: exit(), assert.h, C preprocessor
        !            36: 
        !            37: ***** Notes *****
        !            38: 
        !            39: The Standard requires that  assert be implemented as a macro, not
        !            40: a library function.  If a program suppresses the macro definition
        !            41: in favor of a function call, its behavior is undefined.
        !            42: 
        !            43: Turning off assert with the macro NDEBUG will affect the behavior
        !            44: of a program if the expression being evaluated normally generates
        !            45: side effects.
        !            46: 
        !            47: assert  is useful  for debugging, and  for testing  boundary con-
        !            48: ditions for  which more graceful error recovery  has not yet been
        !            49: implemented.
        !            50: 
        !            51: 
        !            52: 
        !            53: 
        !            54: 
        !            55: 
        !            56: 
        !            57: 
        !            58: 
        !            59: 
        !            60: 
        !            61: 
        !            62: 
        !            63: 
        !            64: COHERENT Lexicon                                           Page 1
        !            65: 
        !            66: 

This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.