blob: 524c5ff028478f7667a0842b0ec1c8e11f4b0ea7 [file] [log] [blame]
Howard Hinnant7a563db2011-09-14 18:33:511// -*- C++ -*-
2//===--------------------------- __debug ----------------------------------===//
3//
Chandler Carruth7c3769d2019-01-19 10:56:404// Part of the LLVM Project, under the Apache License v2.0 with LLVM Exceptions.
5// See https://llvm.org/LICENSE.txt for license information.
6// SPDX-License-Identifier: Apache-2.0 WITH LLVM-exception
Howard Hinnant7a563db2011-09-14 18:33:517//
8//===----------------------------------------------------------------------===//
9
10#ifndef _LIBCPP_DEBUG_H
11#define _LIBCPP_DEBUG_H
12
Eric Fiselierb9536102014-08-10 23:53:0813#include <__config>
Eric Fiseliereb2e3972019-03-18 21:50:1214#include <iosfwd>
Eric Fiselierb9536102014-08-10 23:53:0815
Howard Hinnant499cea12013-08-23 17:37:0516#if !defined(_LIBCPP_HAS_NO_PRAGMA_SYSTEM_HEADER)
17#pragma GCC system_header
18#endif
19
Eric Fiselier32eebb72016-12-28 06:15:0120#if defined(_LIBCPP_HAS_NO_NULLPTR)
21# include <cstddef>
22#endif
23
Eric Fiselier01eb99a2016-12-28 04:58:5224#if _LIBCPP_DEBUG_LEVEL >= 1 || defined(_LIBCPP_BUILDING_LIBRARY)
Howard Hinnant7a563db2011-09-14 18:33:5125# include <cstdlib>
26# include <cstdio>
27# include <cstddef>
Eric Fiselier01eb99a2016-12-28 04:58:5228#endif
29
30#if _LIBCPP_DEBUG_LEVEL >= 1 && !defined(_LIBCPP_ASSERT)
31# define _LIBCPP_ASSERT(x, m) ((x) ? (void)0 : \
Eric Fiselierfa31c102016-12-28 05:26:5632 _VSTD::__libcpp_debug_function(_VSTD::__libcpp_debug_info(__FILE__, __LINE__, #x, m)))
Eric Fiselierb9536102014-08-10 23:53:0833#endif
Howard Hinnant7a563db2011-09-14 18:33:5134
Eric Fiselierf6535882016-07-23 20:36:5535#if _LIBCPP_DEBUG_LEVEL >= 2
36#ifndef _LIBCPP_DEBUG_ASSERT
37#define _LIBCPP_DEBUG_ASSERT(x, m) _LIBCPP_ASSERT(x, m)
38#endif
39#define _LIBCPP_DEBUG_MODE(...) __VA_ARGS__
40#endif
41
Eric Fiselierb9536102014-08-10 23:53:0842#ifndef _LIBCPP_ASSERT
43# define _LIBCPP_ASSERT(x, m) ((void)0)
Howard Hinnantabe26282011-09-16 17:29:1744#endif
Eric Fiselierf6535882016-07-23 20:36:5545#ifndef _LIBCPP_DEBUG_ASSERT
46# define _LIBCPP_DEBUG_ASSERT(x, m) ((void)0)
47#endif
48#ifndef _LIBCPP_DEBUG_MODE
49#define _LIBCPP_DEBUG_MODE(...) ((void)0)
50#endif
Howard Hinnantabe26282011-09-16 17:29:1751
Howard Hinnant7a563db2011-09-14 18:33:5152_LIBCPP_BEGIN_NAMESPACE_STD
53
Eric Fiselierc3589a82017-01-04 23:56:0054struct _LIBCPP_TEMPLATE_VIS __libcpp_debug_info {
Eric Fiselierfa31c102016-12-28 05:26:5655 _LIBCPP_INLINE_VISIBILITY _LIBCPP_CONSTEXPR
Eric Fiselier72a67ff2016-12-28 05:56:1656 __libcpp_debug_info()
57 : __file_(nullptr), __line_(-1), __pred_(nullptr), __msg_(nullptr) {}
58 _LIBCPP_INLINE_VISIBILITY _LIBCPP_CONSTEXPR
Eric Fiselierfa31c102016-12-28 05:26:5659 __libcpp_debug_info(const char* __f, int __l, const char* __p, const char* __m)
60 : __file_(__f), __line_(__l), __pred_(__p), __msg_(__m) {}
Eric Fiseliereb2e3972019-03-18 21:50:1261
62 _LIBCPP_FUNC_VIS std::string what() const;
63
Eric Fiselier01eb99a2016-12-28 04:58:5264 const char* __file_;
65 int __line_;
66 const char* __pred_;
67 const char* __msg_;
68};
69
70/// __libcpp_debug_function_type - The type of the assertion failure handler.
71typedef void(*__libcpp_debug_function_type)(__libcpp_debug_info const&);
72
73/// __libcpp_debug_function - The handler function called when a _LIBCPP_ASSERT
74/// fails.
Louis Dionne07f95bd2018-10-25 12:13:4375extern _LIBCPP_EXPORTED_FROM_ABI __libcpp_debug_function_type __libcpp_debug_function;
Eric Fiselier01eb99a2016-12-28 04:58:5276
77/// __libcpp_abort_debug_function - A debug handler that aborts when called.
78_LIBCPP_NORETURN _LIBCPP_FUNC_VIS
79void __libcpp_abort_debug_function(__libcpp_debug_info const&);
80
Eric Fiselier01eb99a2016-12-28 04:58:5281/// __libcpp_set_debug_function - Set the debug handler to the specified
82/// function.
83_LIBCPP_FUNC_VIS
84bool __libcpp_set_debug_function(__libcpp_debug_function_type __func);
85
Eric Fiselier01eb99a2016-12-28 04:58:5286#if _LIBCPP_DEBUG_LEVEL >= 2 || defined(_LIBCPP_BUILDING_LIBRARY)
87
Howard Hinnant83eade62013-03-06 23:30:1988struct _LIBCPP_TYPE_VIS __c_node;
Howard Hinnant7a563db2011-09-14 18:33:5189
Howard Hinnant83eade62013-03-06 23:30:1990struct _LIBCPP_TYPE_VIS __i_node
Howard Hinnant7a563db2011-09-14 18:33:5191{
92 void* __i_;
93 __i_node* __next_;
94 __c_node* __c_;
95
Eric Fiselier8eb066a2017-01-06 20:58:2596#ifndef _LIBCPP_CXX03_LANG
Howard Hinnant7a563db2011-09-14 18:33:5197 __i_node(const __i_node&) = delete;
98 __i_node& operator=(const __i_node&) = delete;
Howard Hinnant499cea12013-08-23 17:37:0599#else
100private:
101 __i_node(const __i_node&);
102 __i_node& operator=(const __i_node&);
103public:
104#endif
Howard Hinnant7a563db2011-09-14 18:33:51105 _LIBCPP_INLINE_VISIBILITY
106 __i_node(void* __i, __i_node* __next, __c_node* __c)
107 : __i_(__i), __next_(__next), __c_(__c) {}
108 ~__i_node();
109};
110
Howard Hinnant83eade62013-03-06 23:30:19111struct _LIBCPP_TYPE_VIS __c_node
Howard Hinnant7a563db2011-09-14 18:33:51112{
113 void* __c_;
114 __c_node* __next_;
115 __i_node** beg_;
116 __i_node** end_;
117 __i_node** cap_;
118
Eric Fiselier8eb066a2017-01-06 20:58:25119#ifndef _LIBCPP_CXX03_LANG
Howard Hinnant7a563db2011-09-14 18:33:51120 __c_node(const __c_node&) = delete;
121 __c_node& operator=(const __c_node&) = delete;
Howard Hinnant499cea12013-08-23 17:37:05122#else
123private:
124 __c_node(const __c_node&);
125 __c_node& operator=(const __c_node&);
126public:
127#endif
Howard Hinnant7a563db2011-09-14 18:33:51128 _LIBCPP_INLINE_VISIBILITY
129 __c_node(void* __c, __c_node* __next)
130 : __c_(__c), __next_(__next), beg_(nullptr), end_(nullptr), cap_(nullptr) {}
131 virtual ~__c_node();
132
133 virtual bool __dereferenceable(const void*) const = 0;
134 virtual bool __decrementable(const void*) const = 0;
135 virtual bool __addable(const void*, ptrdiff_t) const = 0;
136 virtual bool __subscriptable(const void*, ptrdiff_t) const = 0;
137
Howard Hinnant1c3ec6d2011-09-27 23:55:03138 void __add(__i_node* __i);
Howard Hinnant7a563db2011-09-14 18:33:51139 _LIBCPP_HIDDEN void __remove(__i_node* __i);
140};
141
142template <class _Cont>
143struct _C_node
144 : public __c_node
145{
146 _C_node(void* __c, __c_node* __n)
147 : __c_node(__c, __n) {}
148
149 virtual bool __dereferenceable(const void*) const;
150 virtual bool __decrementable(const void*) const;
151 virtual bool __addable(const void*, ptrdiff_t) const;
152 virtual bool __subscriptable(const void*, ptrdiff_t) const;
153};
154
155template <class _Cont>
Eric Fiselier01eb99a2016-12-28 04:58:52156inline bool
Howard Hinnant7a563db2011-09-14 18:33:51157_C_node<_Cont>::__dereferenceable(const void* __i) const
158{
159 typedef typename _Cont::const_iterator iterator;
160 const iterator* __j = static_cast<const iterator*>(__i);
Howard Hinnant99968442011-11-29 18:15:50161 _Cont* _Cp = static_cast<_Cont*>(__c_);
162 return _Cp->__dereferenceable(__j);
Howard Hinnant7a563db2011-09-14 18:33:51163}
164
165template <class _Cont>
Eric Fiselier01eb99a2016-12-28 04:58:52166inline bool
Howard Hinnant7a563db2011-09-14 18:33:51167_C_node<_Cont>::__decrementable(const void* __i) const
168{
169 typedef typename _Cont::const_iterator iterator;
170 const iterator* __j = static_cast<const iterator*>(__i);
Howard Hinnant99968442011-11-29 18:15:50171 _Cont* _Cp = static_cast<_Cont*>(__c_);
172 return _Cp->__decrementable(__j);
Howard Hinnant7a563db2011-09-14 18:33:51173}
174
175template <class _Cont>
Eric Fiselier01eb99a2016-12-28 04:58:52176inline bool
Howard Hinnant7a563db2011-09-14 18:33:51177_C_node<_Cont>::__addable(const void* __i, ptrdiff_t __n) const
178{
179 typedef typename _Cont::const_iterator iterator;
180 const iterator* __j = static_cast<const iterator*>(__i);
Howard Hinnant99968442011-11-29 18:15:50181 _Cont* _Cp = static_cast<_Cont*>(__c_);
182 return _Cp->__addable(__j, __n);
Howard Hinnant7a563db2011-09-14 18:33:51183}
184
185template <class _Cont>
Eric Fiselier01eb99a2016-12-28 04:58:52186inline bool
Howard Hinnant7a563db2011-09-14 18:33:51187_C_node<_Cont>::__subscriptable(const void* __i, ptrdiff_t __n) const
188{
189 typedef typename _Cont::const_iterator iterator;
190 const iterator* __j = static_cast<const iterator*>(__i);
Howard Hinnant99968442011-11-29 18:15:50191 _Cont* _Cp = static_cast<_Cont*>(__c_);
192 return _Cp->__subscriptable(__j, __n);
Howard Hinnant7a563db2011-09-14 18:33:51193}
194
Howard Hinnant83eade62013-03-06 23:30:19195class _LIBCPP_TYPE_VIS __libcpp_db
Howard Hinnant7a563db2011-09-14 18:33:51196{
197 __c_node** __cbeg_;
198 __c_node** __cend_;
199 size_t __csz_;
200 __i_node** __ibeg_;
201 __i_node** __iend_;
202 size_t __isz_;
203
204 __libcpp_db();
205public:
Eric Fiselier8eb066a2017-01-06 20:58:25206#ifndef _LIBCPP_CXX03_LANG
Howard Hinnant7a563db2011-09-14 18:33:51207 __libcpp_db(const __libcpp_db&) = delete;
208 __libcpp_db& operator=(const __libcpp_db&) = delete;
Howard Hinnant499cea12013-08-23 17:37:05209#else
210private:
211 __libcpp_db(const __libcpp_db&);
212 __libcpp_db& operator=(const __libcpp_db&);
213public:
214#endif
Howard Hinnant7a563db2011-09-14 18:33:51215 ~__libcpp_db();
216
217 class __db_c_iterator;
218 class __db_c_const_iterator;
219 class __db_i_iterator;
220 class __db_i_const_iterator;
221
222 __db_c_const_iterator __c_end() const;
223 __db_i_const_iterator __i_end() const;
224
Eric Fiselier1f820d82019-03-05 02:10:31225 typedef __c_node*(_InsertConstruct)(void*, void*, __c_node*);
226
227 template <class _Cont>
228 _LIBCPP_INLINE_VISIBILITY static __c_node* __create_C_node(void *__mem, void *__c, __c_node *__next) {
229 return ::new(__mem) _C_node<_Cont>(__c, __next);
230 }
231
Howard Hinnant7a563db2011-09-14 18:33:51232 template <class _Cont>
233 _LIBCPP_INLINE_VISIBILITY
234 void __insert_c(_Cont* __c)
235 {
Eric Fiselier1f820d82019-03-05 02:10:31236 __insert_c(static_cast<void*>(__c), &__create_C_node<_Cont>);
Howard Hinnant7a563db2011-09-14 18:33:51237 }
238
Howard Hinnant7608b4a2011-09-16 19:52:23239 void __insert_i(void* __i);
Eric Fiselier1f820d82019-03-05 02:10:31240 void __insert_c(void* __c, _InsertConstruct* __fn);
Howard Hinnant7a563db2011-09-14 18:33:51241 void __erase_c(void* __c);
242
243 void __insert_ic(void* __i, const void* __c);
244 void __iterator_copy(void* __i, const void* __i0);
245 void __erase_i(void* __i);
246
247 void* __find_c_from_i(void* __i) const;
248 void __invalidate_all(void* __c);
249 __c_node* __find_c_and_lock(void* __c) const;
Howard Hinnant1c3ec6d2011-09-27 23:55:03250 __c_node* __find_c(void* __c) const;
Howard Hinnant7a563db2011-09-14 18:33:51251 void unlock() const;
252
253 void swap(void* __c1, void* __c2);
254
255
256 bool __dereferenceable(const void* __i) const;
257 bool __decrementable(const void* __i) const;
258 bool __addable(const void* __i, ptrdiff_t __n) const;
259 bool __subscriptable(const void* __i, ptrdiff_t __n) const;
Howard Hinnant8b00e6c2013-08-02 00:26:35260 bool __less_than_comparable(const void* __i, const void* __j) const;
Howard Hinnant7a563db2011-09-14 18:33:51261private:
262 _LIBCPP_HIDDEN
263 __i_node* __insert_iterator(void* __i);
264 _LIBCPP_HIDDEN
265 __i_node* __find_iterator(const void* __i) const;
266
Howard Hinnant83eade62013-03-06 23:30:19267 friend _LIBCPP_FUNC_VIS __libcpp_db* __get_db();
Howard Hinnant7a563db2011-09-14 18:33:51268};
269
Howard Hinnant83eade62013-03-06 23:30:19270_LIBCPP_FUNC_VIS __libcpp_db* __get_db();
271_LIBCPP_FUNC_VIS const __libcpp_db* __get_const_db();
Howard Hinnant7a563db2011-09-14 18:33:51272
273
Eric Fiselier01eb99a2016-12-28 04:58:52274#endif // _LIBCPP_DEBUG_LEVEL >= 2 || defined(_LIBCPP_BUILDING_LIBRARY)
Howard Hinnant7a563db2011-09-14 18:33:51275
Eric Fiselier01eb99a2016-12-28 04:58:52276_LIBCPP_END_NAMESPACE_STD
Howard Hinnantabe26282011-09-16 17:29:17277
Howard Hinnant7a563db2011-09-14 18:33:51278#endif // _LIBCPP_DEBUG_H
279