Where Online Learning is simpler!

The C and C++ Include Header Files

/usr/include/c++/13/debug/debug.h


$ cat -n /usr/include/c++/13/debug/debug.h

     1	// Debugging support implementation -*- C++ -*-
     2	
     3	// Copyright (C) 2003-2023 Free Software Foundation, Inc.
     4	//
     5	// This file is part of the GNU ISO C++ Library.  This library is free
     6	// software; you can redistribute it and/or modify it under the
     7	// terms of the GNU General Public License as published by the
     8	// Free Software Foundation; either version 3, or (at your option)
     9	// any later version.
    10	
    11	// This library is distributed in the hope that it will be useful,
    12	// but WITHOUT ANY WARRANTY; without even the implied warranty of
    13	// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
    14	// GNU General Public License for more details.
    15	
    16	// Under Section 7 of GPL version 3, you are granted additional
    17	// permissions described in the GCC Runtime Library Exception, version
    18	// 3.1, as published by the Free Software Foundation.
    19	
    20	// You should have received a copy of the GNU General Public License and
    21	// a copy of the GCC Runtime Library Exception along with this program;
    22	// see the files COPYING3 and COPYING.RUNTIME respectively.  If not, see
    23	// <http://www.gnu.org/licenses/>.
    24	
    25	/** @file debug/debug.h
    26	 *  This file is a GNU debug extension to the Standard C++ Library.
    27	 */
    28	
    29	#ifndef _GLIBCXX_DEBUG_MACRO_SWITCH_H
    30	#define _GLIBCXX_DEBUG_MACRO_SWITCH_H 1
    31	
    32	/** Macros and namespaces used by the implementation outside of debug
    33	 *  wrappers to verify certain properties. The __glibcxx_requires_xxx
    34	 *  macros are merely wrappers around the __glibcxx_check_xxx wrappers
    35	 *  when we are compiling with debug mode, but disappear when we are
    36	 *  in release mode so that there is no checking performed in, e.g.,
    37	 *  the standard library algorithms.
    38	*/
    39	
    40	#include <debug/assertions.h>
    41	
    42	// Debug mode namespaces.
    43	
    44	/**
    45	 * @namespace std::__debug
    46	 * @brief GNU debug code, replaces standard behavior with debug behavior.
    47	 */
    48	namespace std
    49	{ 
    50	  namespace __debug { } 
    51	}
    52	
    53	/** @namespace __gnu_debug
    54	 *  @brief GNU debug classes for public use.
    55	*/
    56	namespace __gnu_debug
    57	{
    58	  using namespace std::__debug;
    59	
    60	  template<typename _Ite, typename _Seq, typename _Cat>
    61	    struct _Safe_iterator;
    62	}
    63	
    64	#if ! defined _GLIBCXX_DEBUG || ! _GLIBCXX_HOSTED
    65	
    66	# define __glibcxx_requires_cond(_Cond,_Msg)
    67	# define __glibcxx_requires_valid_range(_First,_Last)
    68	# define __glibcxx_requires_can_increment(_First,_Size)
    69	# define __glibcxx_requires_can_increment_range(_First1,_Last1,_First2)
    70	# define __glibcxx_requires_can_decrement_range(_First1,_Last1,_First2)
    71	# define __glibcxx_requires_sorted(_First,_Last)
    72	# define __glibcxx_requires_sorted_pred(_First,_Last,_Pred)
    73	# define __glibcxx_requires_sorted_set(_First1,_Last1,_First2)
    74	# define __glibcxx_requires_sorted_set_pred(_First1,_Last1,_First2,_Pred)
    75	# define __glibcxx_requires_partitioned_lower(_First,_Last,_Value)
    76	# define __glibcxx_requires_partitioned_upper(_First,_Last,_Value)
    77	# define __glibcxx_requires_partitioned_lower_pred(_First,_Last,_Value,_Pred)
    78	# define __glibcxx_requires_partitioned_upper_pred(_First,_Last,_Value,_Pred)
    79	# define __glibcxx_requires_heap(_First,_Last)
    80	# define __glibcxx_requires_heap_pred(_First,_Last,_Pred)
    81	# define __glibcxx_requires_string(_String)
    82	# define __glibcxx_requires_string_len(_String,_Len)
    83	# define __glibcxx_requires_irreflexive(_First,_Last)
    84	# define __glibcxx_requires_irreflexive2(_First,_Last)
    85	# define __glibcxx_requires_irreflexive_pred(_First,_Last,_Pred)
    86	# define __glibcxx_requires_irreflexive_pred2(_First,_Last,_Pred)
    87	
    88	#else
    89	
    90	# include <debug/macros.h>
    91	
    92	# define __glibcxx_requires_cond(_Cond,_Msg) _GLIBCXX_DEBUG_VERIFY(_Cond,_Msg)
    93	# define __glibcxx_requires_valid_range(_First,_Last)	\
    94	  __glibcxx_check_valid_range(_First,_Last)
    95	# define __glibcxx_requires_can_increment(_First,_Size)	\
    96	  __glibcxx_check_can_increment(_First,_Size)
    97	# define __glibcxx_requires_can_increment_range(_First1,_Last1,_First2)	\
    98	  __glibcxx_check_can_increment_range(_First1,_Last1,_First2)
    99	# define __glibcxx_requires_can_decrement_range(_First1,_Last1,_First2)	\
   100	  __glibcxx_check_can_decrement_range(_First1,_Last1,_First2)
   101	# define __glibcxx_requires_sorted(_First,_Last)	\
   102	  __glibcxx_check_sorted(_First,_Last)
   103	# define __glibcxx_requires_sorted_pred(_First,_Last,_Pred)	\
   104	  __glibcxx_check_sorted_pred(_First,_Last,_Pred)
   105	# define __glibcxx_requires_sorted_set(_First1,_Last1,_First2)	\
   106	  __glibcxx_check_sorted_set(_First1,_Last1,_First2)
   107	# define __glibcxx_requires_sorted_set_pred(_First1,_Last1,_First2,_Pred) \
   108	  __glibcxx_check_sorted_set_pred(_First1,_Last1,_First2,_Pred)
   109	# define __glibcxx_requires_partitioned_lower(_First,_Last,_Value)	\
   110	  __glibcxx_check_partitioned_lower(_First,_Last,_Value)
   111	# define __glibcxx_requires_partitioned_upper(_First,_Last,_Value)	\
   112	  __glibcxx_check_partitioned_upper(_First,_Last,_Value)
   113	# define __glibcxx_requires_partitioned_lower_pred(_First,_Last,_Value,_Pred) \
   114	  __glibcxx_check_partitioned_lower_pred(_First,_Last,_Value,_Pred)
   115	# define __glibcxx_requires_partitioned_upper_pred(_First,_Last,_Value,_Pred) \
   116	  __glibcxx_check_partitioned_upper_pred(_First,_Last,_Value,_Pred)
   117	# define __glibcxx_requires_heap(_First,_Last)	\
   118	  __glibcxx_check_heap(_First,_Last)
   119	# define __glibcxx_requires_heap_pred(_First,_Last,_Pred)	\
   120	  __glibcxx_check_heap_pred(_First,_Last,_Pred)
   121	# if __cplusplus < 201103L
   122	#  define __glibcxx_requires_string(_String)	\
   123	  _GLIBCXX_DEBUG_PEDASSERT(_String != 0)
   124	#  define __glibcxx_requires_string_len(_String,_Len)	\
   125	  _GLIBCXX_DEBUG_PEDASSERT(_String != 0 || _Len == 0)
   126	# else
   127	#  define __glibcxx_requires_string(_String)	\
   128	  _GLIBCXX_DEBUG_PEDASSERT(_String != nullptr)
   129	#  define __glibcxx_requires_string_len(_String,_Len)	\
   130	  _GLIBCXX_DEBUG_PEDASSERT(_String != nullptr || _Len == 0)
   131	# endif
   132	# define __glibcxx_requires_irreflexive(_First,_Last)	\
   133	  __glibcxx_check_irreflexive(_First,_Last)
   134	# define __glibcxx_requires_irreflexive2(_First,_Last)	\
   135	  __glibcxx_check_irreflexive2(_First,_Last)
   136	# define __glibcxx_requires_irreflexive_pred(_First,_Last,_Pred)	\
   137	  __glibcxx_check_irreflexive_pred(_First,_Last,_Pred)
   138	# define __glibcxx_requires_irreflexive_pred2(_First,_Last,_Pred)	\
   139	  __glibcxx_check_irreflexive_pred2(_First,_Last,_Pred)
   140	
   141	# include <debug/functions.h>
   142	
   143	#endif
   144	
   145	#endif // _GLIBCXX_DEBUG_MACRO_SWITCH_H