assert/assert.h

   1 /* Copyright (C) 1991,1992,1994-2001,2003,2004,2007,2011,2012
   2    Free Software Foundation, Inc.
   3    This file is part of the GNU C Library.
   4
   5    The GNU C Library is free software; you can redistribute it and/or
   6    modify it under the terms of the GNU Lesser General Public
   7    License as published by the Free Software Foundation; either
   8    version 2.1 of the License, or (at your option) any later version.
   9
  10    The GNU C Library is distributed in the hope that it will be useful,
  11    but WITHOUT ANY WARRANTY; without even the implied warranty of
  12    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
  13    Lesser General Public License for more details.
  14
  15    You should have received a copy of the GNU Lesser General Public
  16    License along with the GNU C Library; if not, write to the Free
  17    Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA
  18    02111-1307 USA.  */
  19
  20 /*
  21  *      ISO C99 Standard: 7.2 Diagnostics       <assert.h>
  22  */
  23
  24 #ifdef  _ASSERT_H
  25
  26 # undef _ASSERT_H
  27 # undef assert
  28 # undef __ASSERT_VOID_CAST
  29
  30 # ifdef __USE_GNU
  31 #  undef assert_perror
  32 # endif
  33
  34 #endif /* assert.h      */
  35
  36 #define _ASSERT_H       1
  37 #include <features.h>
  38
  39 #if defined __cplusplus && __GNUC_PREREQ (2,95)
  40 # define __ASSERT_VOID_CAST static_cast<void>
  41 #else
  42 # define __ASSERT_VOID_CAST (void)
  43 #endif
  44
  45 /* void assert (int expression);
  46
  47    If NDEBUG is defined, do nothing.
  48    If not, and EXPRESSION is zero, print an error message and abort.  */
  49
  50 #ifdef  NDEBUG
  51
  52 # define assert(expr)           (__ASSERT_VOID_CAST (0))
  53
  54 /* void assert_perror (int errnum);
  55
  56    If NDEBUG is defined, do nothing.  If not, and ERRNUM is not zero, print an
  57    error message with the error text for ERRNUM and abort.
  58    (This is a GNU extension.) */
  59
  60 # ifdef __USE_GNU
  61 #  define assert_perror(errnum) (__ASSERT_VOID_CAST (0))
  62 # endif
  63
  64 #else /* Not NDEBUG.  */
  65
  66 __BEGIN_DECLS
  67
  68 /* This prints an "Assertion failed" message and aborts.  */
  69 extern void __assert_fail (const char *__assertion, const char *__file,
  70                            unsigned int __line, const char *__function)
  71      __THROW __attribute__ ((__noreturn__));
  72
  73 /* Likewise, but prints the error text for ERRNUM.  */
  74 extern void __assert_perror_fail (int __errnum, const char *__file,
  75                                   unsigned int __line, const char *__function)
  76      __THROW __attribute__ ((__noreturn__));
  77
  78
  79 /* The following is not at all used here but needed for standard
  80    compliance.  */
  81 extern void __assert (const char *__assertion, const char *__file, int __line)
  82      __THROW __attribute__ ((__noreturn__));
  83
  84
  85 __END_DECLS
  86
  87 # define assert(expr)                                                   \
  88   ((expr)                                                               \
  89    ? __ASSERT_VOID_CAST (0)                                             \
  90    : __assert_fail (__STRING(expr), __FILE__, __LINE__, __ASSERT_FUNCTION))
  91
  92 # ifdef __USE_GNU
  93 #  define assert_perror(errnum)                                         \
  94   (!(errnum)                                                            \
  95    ? __ASSERT_VOID_CAST (0)                                             \
  96    : __assert_perror_fail ((errnum), __FILE__, __LINE__, __ASSERT_FUNCTION))
  97 # endif
  98
  99 /* Version 2.4 and later of GCC define a magical variable `__PRETTY_FUNCTION__'
 100    which contains the name of the function currently being defined.
 101    This is broken in G++ before version 2.6.
 102    C9x has a similar variable called __func__, but prefer the GCC one since
 103    it demangles C++ function names.  */
 104 # if defined __cplusplus ? __GNUC_PREREQ (2, 6) : __GNUC_PREREQ (2, 4)
 105 #   define __ASSERT_FUNCTION    __PRETTY_FUNCTION__
 106 # else
 107 #  if defined __STDC_VERSION__ && __STDC_VERSION__ >= 199901L
 108 #   define __ASSERT_FUNCTION    __func__
 109 #  else
 110 #   define __ASSERT_FUNCTION    ((const char *) 0)
 111 #  endif
 112 # endif
 113
 114 #endif /* NDEBUG.  */
 115
 116
 117 #if defined __USE_ISOC11 && !defined __cplusplus
 118 /* Static assertion.  Requires support in the compiler.  */
 119 # undef static_assert
 120 # define static_assert _Static_assert
 121 #endif