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, see
  17    <http://www.gnu.org/licenses/>.  */
  18
  19 /*
  20  *      ISO C99 Standard: 7.2 Diagnostics       <assert.h>
  21  */
  22
  23 #ifdef  _ASSERT_H
  24
  25 # undef _ASSERT_H
  26 # undef assert
  27 # undef __ASSERT_VOID_CAST
  28
  29 # ifdef __USE_GNU
  30 #  undef assert_perror
  31 # endif
  32
  33 #endif /* assert.h      */
  34
  35 #define _ASSERT_H       1
  36 #include <features.h>
  37
  38 #if defined __cplusplus && __GNUC_PREREQ (2,95)
  39 # define __ASSERT_VOID_CAST static_cast<void>
  40 #else
  41 # define __ASSERT_VOID_CAST (void)
  42 #endif
  43
  44 /* void assert (int expression);
  45
  46    If NDEBUG is defined, do nothing.
  47    If not, and EXPRESSION is zero, print an error message and abort.  */
  48
  49 #ifdef  NDEBUG
  50
  51 # define assert(expr)           (__ASSERT_VOID_CAST (0))
  52
  53 /* void assert_perror (int errnum);
  54
  55    If NDEBUG is defined, do nothing.  If not, and ERRNUM is not zero, print an
  56    error message with the error text for ERRNUM and abort.
  57    (This is a GNU extension.) */
  58
  59 # ifdef __USE_GNU
  60 #  define assert_perror(errnum) (__ASSERT_VOID_CAST (0))
  61 # endif
  62
  63 #else /* Not NDEBUG.  */
  64
  65 __BEGIN_DECLS
  66
  67 /* This prints an "Assertion failed" message and aborts.  */
  68 extern void __assert_fail (const char *__assertion, const char *__file,
  69                            unsigned int __line, const char *__function)
  70      __THROW __attribute__ ((__noreturn__));
  71
  72 /* Likewise, but prints the error text for ERRNUM.  */
  73 extern void __assert_perror_fail (int __errnum, const char *__file,
  74                                   unsigned int __line, const char *__function)
  75      __THROW __attribute__ ((__noreturn__));
  76
  77
  78 /* The following is not at all used here but needed for standard
  79    compliance.  */
  80 extern void __assert (const char *__assertion, const char *__file, int __line)
  81      __THROW __attribute__ ((__noreturn__));
  82
  83
  84 __END_DECLS
  85
  86 # define assert(expr)                                                   \
  87   ((expr)                                                               \
  88    ? __ASSERT_VOID_CAST (0)                                             \
  89    : __assert_fail (__STRING(expr), __FILE__, __LINE__, __ASSERT_FUNCTION))
  90
  91 # ifdef __USE_GNU
  92 #  define assert_perror(errnum)                                         \
  93   (!(errnum)                                                            \
  94    ? __ASSERT_VOID_CAST (0)                                             \
  95    : __assert_perror_fail ((errnum), __FILE__, __LINE__, __ASSERT_FUNCTION))
  96 # endif
  97
  98 /* Version 2.4 and later of GCC define a magical variable `__PRETTY_FUNCTION__'
  99    which contains the name of the function currently being defined.
 100    This is broken in G++ before version 2.6.
 101    C9x has a similar variable called __func__, but prefer the GCC one since
 102    it demangles C++ function names.  */
 103 # if defined __cplusplus ? __GNUC_PREREQ (2, 6) : __GNUC_PREREQ (2, 4)
 104 #   define __ASSERT_FUNCTION    __PRETTY_FUNCTION__
 105 # else
 106 #  if defined __STDC_VERSION__ && __STDC_VERSION__ >= 199901L
 107 #   define __ASSERT_FUNCTION    __func__
 108 #  else
 109 #   define __ASSERT_FUNCTION    ((const char *) 0)
 110 #  endif
 111 # endif
 112
 113 #endif /* NDEBUG.  */
 114
 115
 116 #if defined __USE_ISOC11 && !defined __cplusplus
 117 /* Static assertion.  Requires support in the compiler.  */
 118 # undef static_assert
 119 # define static_assert _Static_assert
 120 #endif