| 1 |
// Allocator traits -*- C++ -*- |
| 2 |
|
| 3 |
// Copyright (C) 2011-2021 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 bits/alloc_traits.h |
| 26 |
* This is an internal header file, included by other library headers. |
| 27 |
* Do not attempt to use it directly. @headername{memory} |
| 28 |
*/ |
| 29 |
|
| 30 |
#ifndef _ALLOC_TRAITS_H |
| 31 |
#define _ALLOC_TRAITS_H 1 |
| 32 |
|
| 33 |
#include <bits/stl_construct.h> |
| 34 |
#include <bits/memoryfwd.h> |
| 35 |
#if __cplusplus >= 201103L |
| 36 |
# include <bits/allocator.h> |
| 37 |
# include <bits/ptr_traits.h> |
| 38 |
# include <ext/numeric_traits.h> |
| 39 |
#endif |
| 40 |
|
| 41 |
namespace std _GLIBCXX_VISIBILITY(default) |
| 42 |
{ |
| 43 |
_GLIBCXX_BEGIN_NAMESPACE_VERSION |
| 44 |
|
| 45 |
#if __cplusplus >= 201103L |
| 46 |
#define __cpp_lib_allocator_traits_is_always_equal 201411 |
| 47 |
|
| 48 |
struct __allocator_traits_base |
| 49 |
{ |
| 50 |
template<typename _Tp, typename _Up, typename = void> |
| 51 |
struct __rebind : __replace_first_arg<_Tp, _Up> { }; |
| 52 |
|
| 53 |
template<typename _Tp, typename _Up> |
| 54 |
struct __rebind<_Tp, _Up, |
| 55 |
__void_t<typename _Tp::template rebind<_Up>::other>> |
| 56 |
{ using type = typename _Tp::template rebind<_Up>::other; }; |
| 57 |
|
| 58 |
protected: |
| 59 |
template<typename _Tp> |
| 60 |
using __pointer = typename _Tp::pointer; |
| 61 |
template<typename _Tp> |
| 62 |
using __c_pointer = typename _Tp::const_pointer; |
| 63 |
template<typename _Tp> |
| 64 |
using __v_pointer = typename _Tp::void_pointer; |
| 65 |
template<typename _Tp> |
| 66 |
using __cv_pointer = typename _Tp::const_void_pointer; |
| 67 |
template<typename _Tp> |
| 68 |
using __pocca = typename _Tp::propagate_on_container_copy_assignment; |
| 69 |
template<typename _Tp> |
| 70 |
using __pocma = typename _Tp::propagate_on_container_move_assignment; |
| 71 |
template<typename _Tp> |
| 72 |
using __pocs = typename _Tp::propagate_on_container_swap; |
| 73 |
template<typename _Tp> |
| 74 |
using __equal = typename _Tp::is_always_equal; |
| 75 |
}; |
| 76 |
|
| 77 |
template<typename _Alloc, typename _Up> |
| 78 |
using __alloc_rebind |
| 79 |
= typename __allocator_traits_base::template __rebind<_Alloc, _Up>::type; |
| 80 |
|
| 81 |
/** |
| 82 |
* @brief Uniform interface to all allocator types. |
| 83 |
* @ingroup allocators |
| 84 |
*/ |
| 85 |
template<typename _Alloc> |
| 86 |
struct allocator_traits : __allocator_traits_base |
| 87 |
{ |
| 88 |
/// The allocator type |
| 89 |
typedef _Alloc allocator_type; |
| 90 |
/// The allocated type |
| 91 |
typedef typename _Alloc::value_type value_type; |
| 92 |
|
| 93 |
/** |
| 94 |
* @brief The allocator's pointer type. |
| 95 |
* |
| 96 |
* @c Alloc::pointer if that type exists, otherwise @c value_type* |
| 97 |
*/ |
| 98 |
using pointer = __detected_or_t<value_type*, __pointer, _Alloc>; |
| 99 |
|
| 100 |
private: |
| 101 |
// Select _Func<_Alloc> or pointer_traits<pointer>::rebind<_Tp> |
| 102 |
template<template<typename> class _Func, typename _Tp, typename = void> |
| 103 |
struct _Ptr |
| 104 |
{ |
| 105 |
using type = typename pointer_traits<pointer>::template rebind<_Tp>; |
| 106 |
}; |
| 107 |
|
| 108 |
template<template<typename> class _Func, typename _Tp> |
| 109 |
struct _Ptr<_Func, _Tp, __void_t<_Func<_Alloc>>> |
| 110 |
{ |
| 111 |
using type = _Func<_Alloc>; |
| 112 |
}; |
| 113 |
|
| 114 |
// Select _A2::difference_type or pointer_traits<_Ptr>::difference_type |
| 115 |
template<typename _A2, typename _PtrT, typename = void> |
| 116 |
struct _Diff |
| 117 |
{ using type = typename pointer_traits<_PtrT>::difference_type; }; |
| 118 |
|
| 119 |
template<typename _A2, typename _PtrT> |
| 120 |
struct _Diff<_A2, _PtrT, __void_t<typename _A2::difference_type>> |
| 121 |
{ using type = typename _A2::difference_type; }; |
| 122 |
|
| 123 |
// Select _A2::size_type or make_unsigned<_DiffT>::type |
| 124 |
template<typename _A2, typename _DiffT, typename = void> |
| 125 |
struct _Size : make_unsigned<_DiffT> { }; |
| 126 |
|
| 127 |
template<typename _A2, typename _DiffT> |
| 128 |
struct _Size<_A2, _DiffT, __void_t<typename _A2::size_type>> |
| 129 |
{ using type = typename _A2::size_type; }; |
| 130 |
|
| 131 |
public: |
| 132 |
/** |
| 133 |
* @brief The allocator's const pointer type. |
| 134 |
* |
| 135 |
* @c Alloc::const_pointer if that type exists, otherwise |
| 136 |
* <tt> pointer_traits<pointer>::rebind<const value_type> </tt> |
| 137 |
*/ |
| 138 |
using const_pointer = typename _Ptr<__c_pointer, const value_type>::type; |
| 139 |
|
| 140 |
/** |
| 141 |
* @brief The allocator's void pointer type. |
| 142 |
* |
| 143 |
* @c Alloc::void_pointer if that type exists, otherwise |
| 144 |
* <tt> pointer_traits<pointer>::rebind<void> </tt> |
| 145 |
*/ |
| 146 |
using void_pointer = typename _Ptr<__v_pointer, void>::type; |
| 147 |
|
| 148 |
/** |
| 149 |
* @brief The allocator's const void pointer type. |
| 150 |
* |
| 151 |
* @c Alloc::const_void_pointer if that type exists, otherwise |
| 152 |
* <tt> pointer_traits<pointer>::rebind<const void> </tt> |
| 153 |
*/ |
| 154 |
using const_void_pointer = typename _Ptr<__cv_pointer, const void>::type; |
| 155 |
|
| 156 |
/** |
| 157 |
* @brief The allocator's difference type |
| 158 |
* |
| 159 |
* @c Alloc::difference_type if that type exists, otherwise |
| 160 |
* <tt> pointer_traits<pointer>::difference_type </tt> |
| 161 |
*/ |
| 162 |
using difference_type = typename _Diff<_Alloc, pointer>::type; |
| 163 |
|
| 164 |
/** |
| 165 |
* @brief The allocator's size type |
| 166 |
* |
| 167 |
* @c Alloc::size_type if that type exists, otherwise |
| 168 |
* <tt> make_unsigned<difference_type>::type </tt> |
| 169 |
*/ |
| 170 |
using size_type = typename _Size<_Alloc, difference_type>::type; |
| 171 |
|
| 172 |
/** |
| 173 |
* @brief How the allocator is propagated on copy assignment |
| 174 |
* |
| 175 |
* @c Alloc::propagate_on_container_copy_assignment if that type exists, |
| 176 |
* otherwise @c false_type |
| 177 |
*/ |
| 178 |
using propagate_on_container_copy_assignment |
| 179 |
= __detected_or_t<false_type, __pocca, _Alloc>; |
| 180 |
|
| 181 |
/** |
| 182 |
* @brief How the allocator is propagated on move assignment |
| 183 |
* |
| 184 |
* @c Alloc::propagate_on_container_move_assignment if that type exists, |
| 185 |
* otherwise @c false_type |
| 186 |
*/ |
| 187 |
using propagate_on_container_move_assignment |
| 188 |
= __detected_or_t<false_type, __pocma, _Alloc>; |
| 189 |
|
| 190 |
/** |
| 191 |
* @brief How the allocator is propagated on swap |
| 192 |
* |
| 193 |
* @c Alloc::propagate_on_container_swap if that type exists, |
| 194 |
* otherwise @c false_type |
| 195 |
*/ |
| 196 |
using propagate_on_container_swap |
| 197 |
= __detected_or_t<false_type, __pocs, _Alloc>; |
| 198 |
|
| 199 |
/** |
| 200 |
* @brief Whether all instances of the allocator type compare equal. |
| 201 |
* |
| 202 |
* @c Alloc::is_always_equal if that type exists, |
| 203 |
* otherwise @c is_empty<Alloc>::type |
| 204 |
*/ |
| 205 |
using is_always_equal |
| 206 |
= __detected_or_t<typename is_empty<_Alloc>::type, __equal, _Alloc>; |
| 207 |
|
| 208 |
template<typename _Tp> |
| 209 |
using rebind_alloc = __alloc_rebind<_Alloc, _Tp>; |
| 210 |
template<typename _Tp> |
| 211 |
using rebind_traits = allocator_traits<rebind_alloc<_Tp>>; |
| 212 |
|
| 213 |
private: |
| 214 |
template<typename _Alloc2> |
| 215 |
static constexpr auto |
| 216 |
_S_allocate(_Alloc2& __a, size_type __n, const_void_pointer __hint, int) |
| 217 |
-> decltype(__a.allocate(__n, __hint)) |
| 218 |
{ return __a.allocate(__n, __hint); } |
| 219 |
|
| 220 |
template<typename _Alloc2> |
| 221 |
static constexpr pointer |
| 222 |
_S_allocate(_Alloc2& __a, size_type __n, const_void_pointer, ...) |
| 223 |
{ return __a.allocate(__n); } |
| 224 |
|
| 225 |
template<typename _Tp, typename... _Args> |
| 226 |
struct __construct_helper |
| 227 |
{ |
| 228 |
template<typename _Alloc2, |
| 229 |
typename = decltype(std::declval<_Alloc2*>()->construct( |
| 230 |
std::declval<_Tp*>(), std::declval<_Args>()...))> |
| 231 |
static true_type __test(int); |
| 232 |
|
| 233 |
template<typename> |
| 234 |
static false_type __test(...); |
| 235 |
|
| 236 |
using type = decltype(__test<_Alloc>(0)); |
| 237 |
}; |
| 238 |
|
| 239 |
template<typename _Tp, typename... _Args> |
| 240 |
using __has_construct |
| 241 |
= typename __construct_helper<_Tp, _Args...>::type; |
| 242 |
|
| 243 |
template<typename _Tp, typename... _Args> |
| 244 |
static _GLIBCXX14_CONSTEXPR _Require<__has_construct<_Tp, _Args...>> |
| 245 |
_S_construct(_Alloc& __a, _Tp* __p, _Args&&... __args) |
| 246 |
noexcept(noexcept(__a.construct(__p, std::forward<_Args>(__args)...))) |
| 247 |
{ __a.construct(__p, std::forward<_Args>(__args)...); } |
| 248 |
|
| 249 |
template<typename _Tp, typename... _Args> |
| 250 |
static _GLIBCXX14_CONSTEXPR |
| 251 |
_Require<__and_<__not_<__has_construct<_Tp, _Args...>>, |
| 252 |
is_constructible<_Tp, _Args...>>> |
| 253 |
_S_construct(_Alloc&, _Tp* __p, _Args&&... __args) |
| 254 |
noexcept(std::is_nothrow_constructible<_Tp, _Args...>::value) |
| 255 |
{ |
| 256 |
#if __cplusplus <= 201703L |
| 257 |
::new((void*)__p) _Tp(std::forward<_Args>(__args)...); |
| 258 |
#else |
| 259 |
std::construct_at(__p, std::forward<_Args>(__args)...); |
| 260 |
#endif |
| 261 |
} |
| 262 |
|
| 263 |
template<typename _Alloc2, typename _Tp> |
| 264 |
static _GLIBCXX14_CONSTEXPR auto |
| 265 |
_S_destroy(_Alloc2& __a, _Tp* __p, int) |
| 266 |
noexcept(noexcept(__a.destroy(__p))) |
| 267 |
-> decltype(__a.destroy(__p)) |
| 268 |
{ __a.destroy(__p); } |
| 269 |
|
| 270 |
template<typename _Alloc2, typename _Tp> |
| 271 |
static _GLIBCXX14_CONSTEXPR void |
| 272 |
_S_destroy(_Alloc2&, _Tp* __p, ...) |
| 273 |
noexcept(std::is_nothrow_destructible<_Tp>::value) |
| 274 |
{ std::_Destroy(__p); } |
| 275 |
|
| 276 |
template<typename _Alloc2> |
| 277 |
static constexpr auto |
| 278 |
_S_max_size(_Alloc2& __a, int) |
| 279 |
-> decltype(__a.max_size()) |
| 280 |
{ return __a.max_size(); } |
| 281 |
|
| 282 |
template<typename _Alloc2> |
| 283 |
static constexpr size_type |
| 284 |
_S_max_size(_Alloc2&, ...) |
| 285 |
{ |
| 286 |
// _GLIBCXX_RESOLVE_LIB_DEFECTS |
| 287 |
// 2466. allocator_traits::max_size() default behavior is incorrect |
| 288 |
return __gnu_cxx::__numeric_traits<size_type>::__max |
| 289 |
/ sizeof(value_type); |
| 290 |
} |
| 291 |
|
| 292 |
template<typename _Alloc2> |
| 293 |
static constexpr auto |
| 294 |
_S_select(_Alloc2& __a, int) |
| 295 |
-> decltype(__a.select_on_container_copy_construction()) |
| 296 |
{ return __a.select_on_container_copy_construction(); } |
| 297 |
|
| 298 |
template<typename _Alloc2> |
| 299 |
static constexpr _Alloc2 |
| 300 |
_S_select(_Alloc2& __a, ...) |
| 301 |
{ return __a; } |
| 302 |
|
| 303 |
public: |
| 304 |
|
| 305 |
/** |
| 306 |
* @brief Allocate memory. |
| 307 |
* @param __a An allocator. |
| 308 |
* @param __n The number of objects to allocate space for. |
| 309 |
* |
| 310 |
* Calls @c a.allocate(n) |
| 311 |
*/ |
| 312 |
_GLIBCXX_NODISCARD static _GLIBCXX20_CONSTEXPR pointer |
| 313 |
allocate(_Alloc& __a, size_type __n) |
| 314 |
{ return __a.allocate(__n); } |
| 315 |
|
| 316 |
/** |
| 317 |
* @brief Allocate memory. |
| 318 |
* @param __a An allocator. |
| 319 |
* @param __n The number of objects to allocate space for. |
| 320 |
* @param __hint Aid to locality. |
| 321 |
* @return Memory of suitable size and alignment for @a n objects |
| 322 |
* of type @c value_type |
| 323 |
* |
| 324 |
* Returns <tt> a.allocate(n, hint) </tt> if that expression is |
| 325 |
* well-formed, otherwise returns @c a.allocate(n) |
| 326 |
*/ |
| 327 |
_GLIBCXX_NODISCARD static _GLIBCXX20_CONSTEXPR pointer |
| 328 |
allocate(_Alloc& __a, size_type __n, const_void_pointer __hint) |
| 329 |
{ return _S_allocate(__a, __n, __hint, 0); } |
| 330 |
|
| 331 |
/** |
| 332 |
* @brief Deallocate memory. |
| 333 |
* @param __a An allocator. |
| 334 |
* @param __p Pointer to the memory to deallocate. |
| 335 |
* @param __n The number of objects space was allocated for. |
| 336 |
* |
| 337 |
* Calls <tt> a.deallocate(p, n) </tt> |
| 338 |
*/ |
| 339 |
static _GLIBCXX20_CONSTEXPR void |
| 340 |
deallocate(_Alloc& __a, pointer __p, size_type __n) |
| 341 |
{ __a.deallocate(__p, __n); } |
| 342 |
|
| 343 |
/** |
| 344 |
* @brief Construct an object of type `_Tp` |
| 345 |
* @param __a An allocator. |
| 346 |
* @param __p Pointer to memory of suitable size and alignment for Tp |
| 347 |
* @param __args Constructor arguments. |
| 348 |
* |
| 349 |
* Calls <tt> __a.construct(__p, std::forward<Args>(__args)...) </tt> |
| 350 |
* if that expression is well-formed, otherwise uses placement-new |
| 351 |
* to construct an object of type @a _Tp at location @a __p from the |
| 352 |
* arguments @a __args... |
| 353 |
*/ |
| 354 |
template<typename _Tp, typename... _Args> |
| 355 |
static _GLIBCXX20_CONSTEXPR auto |
| 356 |
construct(_Alloc& __a, _Tp* __p, _Args&&... __args) |
| 357 |
noexcept(noexcept(_S_construct(__a, __p, |
| 358 |
std::forward<_Args>(__args)...))) |
| 359 |
-> decltype(_S_construct(__a, __p, std::forward<_Args>(__args)...)) |
| 360 |
{ _S_construct(__a, __p, std::forward<_Args>(__args)...); } |
| 361 |
|
| 362 |
/** |
| 363 |
* @brief Destroy an object of type @a _Tp |
| 364 |
* @param __a An allocator. |
| 365 |
* @param __p Pointer to the object to destroy |
| 366 |
* |
| 367 |
* Calls @c __a.destroy(__p) if that expression is well-formed, |
| 368 |
* otherwise calls @c __p->~_Tp() |
| 369 |
*/ |
| 370 |
template<typename _Tp> |
| 371 |
static _GLIBCXX20_CONSTEXPR void |
| 372 |
destroy(_Alloc& __a, _Tp* __p) |
| 373 |
noexcept(noexcept(_S_destroy(__a, __p, 0))) |
| 374 |
{ _S_destroy(__a, __p, 0); } |
| 375 |
|
| 376 |
/** |
| 377 |
* @brief The maximum supported allocation size |
| 378 |
* @param __a An allocator. |
| 379 |
* @return @c __a.max_size() or @c numeric_limits<size_type>::max() |
| 380 |
* |
| 381 |
* Returns @c __a.max_size() if that expression is well-formed, |
| 382 |
* otherwise returns @c numeric_limits<size_type>::max() |
| 383 |
*/ |
| 384 |
static _GLIBCXX20_CONSTEXPR size_type |
| 385 |
max_size(const _Alloc& __a) noexcept |
| 386 |
{ return _S_max_size(__a, 0); } |
| 387 |
|
| 388 |
/** |
| 389 |
* @brief Obtain an allocator to use when copying a container. |
| 390 |
* @param __rhs An allocator. |
| 391 |
* @return @c __rhs.select_on_container_copy_construction() or @a __rhs |
| 392 |
* |
| 393 |
* Returns @c __rhs.select_on_container_copy_construction() if that |
| 394 |
* expression is well-formed, otherwise returns @a __rhs |
| 395 |
*/ |
| 396 |
static _GLIBCXX20_CONSTEXPR _Alloc |
| 397 |
select_on_container_copy_construction(const _Alloc& __rhs) |
| 398 |
{ return _S_select(__rhs, 0); } |
| 399 |
}; |
| 400 |
|
| 401 |
#if __cplusplus > 201703L |
| 402 |
# define __cpp_lib_constexpr_dynamic_alloc 201907L |
| 403 |
#endif |
| 404 |
|
| 405 |
/// Partial specialization for std::allocator. |
| 406 |
template<typename _Tp> |
| 407 |
struct allocator_traits<allocator<_Tp>> |
| 408 |
{ |
| 409 |
/// The allocator type |
| 410 |
using allocator_type = allocator<_Tp>; |
| 411 |
|
| 412 |
/// The allocated type |
| 413 |
using value_type = _Tp; |
| 414 |
|
| 415 |
/// The allocator's pointer type. |
| 416 |
using pointer = _Tp*; |
| 417 |
|
| 418 |
/// The allocator's const pointer type. |
| 419 |
using const_pointer = const _Tp*; |
| 420 |
|
| 421 |
/// The allocator's void pointer type. |
| 422 |
using void_pointer = void*; |
| 423 |
|
| 424 |
/// The allocator's const void pointer type. |
| 425 |
using const_void_pointer = const void*; |
| 426 |
|
| 427 |
/// The allocator's difference type |
| 428 |
using difference_type = std::ptrdiff_t; |
| 429 |
|
| 430 |
/// The allocator's size type |
| 431 |
using size_type = std::size_t; |
| 432 |
|
| 433 |
/// How the allocator is propagated on copy assignment |
| 434 |
using propagate_on_container_copy_assignment = false_type; |
| 435 |
|
| 436 |
/// How the allocator is propagated on move assignment |
| 437 |
using propagate_on_container_move_assignment = true_type; |
| 438 |
|
| 439 |
/// How the allocator is propagated on swap |
| 440 |
using propagate_on_container_swap = false_type; |
| 441 |
|
| 442 |
/// Whether all instances of the allocator type compare equal. |
| 443 |
using is_always_equal = true_type; |
| 444 |
|
| 445 |
template<typename _Up> |
| 446 |
using rebind_alloc = allocator<_Up>; |
| 447 |
|
| 448 |
template<typename _Up> |
| 449 |
using rebind_traits = allocator_traits<allocator<_Up>>; |
| 450 |
|
| 451 |
/** |
| 452 |
* @brief Allocate memory. |
| 453 |
* @param __a An allocator. |
| 454 |
* @param __n The number of objects to allocate space for. |
| 455 |
* |
| 456 |
* Calls @c a.allocate(n) |
| 457 |
*/ |
| 458 |
_GLIBCXX_NODISCARD static _GLIBCXX20_CONSTEXPR pointer |
| 459 |
allocate(allocator_type& __a, size_type __n) |
| 460 |
{ return __a.allocate(__n); } |
| 461 |
|
| 462 |
/** |
| 463 |
* @brief Allocate memory. |
| 464 |
* @param __a An allocator. |
| 465 |
* @param __n The number of objects to allocate space for. |
| 466 |
* @param __hint Aid to locality. |
| 467 |
* @return Memory of suitable size and alignment for @a n objects |
| 468 |
* of type @c value_type |
| 469 |
* |
| 470 |
* Returns <tt> a.allocate(n, hint) </tt> |
| 471 |
*/ |
| 472 |
_GLIBCXX_NODISCARD static _GLIBCXX20_CONSTEXPR pointer |
| 473 |
allocate(allocator_type& __a, size_type __n, const_void_pointer __hint) |
| 474 |
{ |
| 475 |
#if __cplusplus <= 201703L |
| 476 |
return __a.allocate(__n, __hint); |
| 477 |
#else |
| 478 |
return __a.allocate(__n); |
| 479 |
#endif |
| 480 |
} |
| 481 |
|
| 482 |
/** |
| 483 |
* @brief Deallocate memory. |
| 484 |
* @param __a An allocator. |
| 485 |
* @param __p Pointer to the memory to deallocate. |
| 486 |
* @param __n The number of objects space was allocated for. |
| 487 |
* |
| 488 |
* Calls <tt> a.deallocate(p, n) </tt> |
| 489 |
*/ |
| 490 |
static _GLIBCXX20_CONSTEXPR void |
| 491 |
deallocate(allocator_type& __a, pointer __p, size_type __n) |
| 492 |
{ __a.deallocate(__p, __n); } |
| 493 |
|
| 494 |
/** |
| 495 |
* @brief Construct an object of type `_Up` |
| 496 |
* @param __a An allocator. |
| 497 |
* @param __p Pointer to memory of suitable size and alignment for |
| 498 |
* an object of type `_Up`. |
| 499 |
* @param __args Constructor arguments. |
| 500 |
* |
| 501 |
* Calls `__a.construct(__p, std::forward<_Args>(__args)...)` |
| 502 |
* in C++11, C++14 and C++17. Changed in C++20 to call |
| 503 |
* `std::construct_at(__p, std::forward<_Args>(__args)...)` instead. |
| 504 |
*/ |
| 505 |
template<typename _Up, typename... _Args> |
| 506 |
static _GLIBCXX20_CONSTEXPR void |
| 507 |
construct(allocator_type& __a __attribute__((__unused__)), _Up* __p, |
| 508 |
_Args&&... __args) |
| 509 |
noexcept(std::is_nothrow_constructible<_Up, _Args...>::value) |
| 510 |
{ |
| 511 |
#if __cplusplus <= 201703L |
| 512 |
__a.construct(__p, std::forward<_Args>(__args)...); |
| 513 |
#else |
| 514 |
std::construct_at(__p, std::forward<_Args>(__args)...); |
| 515 |
#endif |
| 516 |
} |
| 517 |
|
| 518 |
/** |
| 519 |
* @brief Destroy an object of type @a _Up |
| 520 |
* @param __a An allocator. |
| 521 |
* @param __p Pointer to the object to destroy |
| 522 |
* |
| 523 |
* Calls @c __a.destroy(__p). |
| 524 |
*/ |
| 525 |
template<typename _Up> |
| 526 |
static _GLIBCXX20_CONSTEXPR void |
| 527 |
destroy(allocator_type& __a __attribute__((__unused__)), _Up* __p) |
| 528 |
noexcept(is_nothrow_destructible<_Up>::value) |
| 529 |
{ |
| 530 |
#if __cplusplus <= 201703L |
| 531 |
__a.destroy(__p); |
| 532 |
#else |
| 533 |
std::destroy_at(__p); |
| 534 |
#endif |
| 535 |
} |
| 536 |
|
| 537 |
/** |
| 538 |
* @brief The maximum supported allocation size |
| 539 |
* @param __a An allocator. |
| 540 |
* @return @c __a.max_size() |
| 541 |
*/ |
| 542 |
static _GLIBCXX20_CONSTEXPR size_type |
| 543 |
max_size(const allocator_type& __a __attribute__((__unused__))) noexcept |
| 544 |
{ |
| 545 |
#if __cplusplus <= 201703L |
| 546 |
return __a.max_size(); |
| 547 |
#else |
| 548 |
return size_t(-1) / sizeof(value_type); |
| 549 |
#endif |
| 550 |
} |
| 551 |
|
| 552 |
/** |
| 553 |
* @brief Obtain an allocator to use when copying a container. |
| 554 |
* @param __rhs An allocator. |
| 555 |
* @return @c __rhs |
| 556 |
*/ |
| 557 |
static _GLIBCXX20_CONSTEXPR allocator_type |
| 558 |
select_on_container_copy_construction(const allocator_type& __rhs) |
| 559 |
{ return __rhs; } |
| 560 |
}; |
| 561 |
|
| 562 |
#if __cplusplus < 201703L |
| 563 |
template<typename _Alloc> |
| 564 |
inline void |
| 565 |
__do_alloc_on_copy(_Alloc& __one, const _Alloc& __two, true_type) |
| 566 |
{ __one = __two; } |
| 567 |
|
| 568 |
template<typename _Alloc> |
| 569 |
inline void |
| 570 |
__do_alloc_on_copy(_Alloc&, const _Alloc&, false_type) |
| 571 |
{ } |
| 572 |
#endif |
| 573 |
|
| 574 |
template<typename _Alloc> |
| 575 |
_GLIBCXX14_CONSTEXPR inline void |
| 576 |
__alloc_on_copy(_Alloc& __one, const _Alloc& __two) |
| 577 |
{ |
| 578 |
typedef allocator_traits<_Alloc> __traits; |
| 579 |
typedef typename __traits::propagate_on_container_copy_assignment __pocca; |
| 580 |
#if __cplusplus >= 201703L |
| 581 |
if constexpr (__pocca::value) |
| 582 |
__one = __two; |
| 583 |
#else |
| 584 |
__do_alloc_on_copy(__one, __two, __pocca()); |
| 585 |
#endif |
| 586 |
} |
| 587 |
|
| 588 |
template<typename _Alloc> |
| 589 |
constexpr _Alloc |
| 590 |
__alloc_on_copy(const _Alloc& __a) |
| 591 |
{ |
| 592 |
typedef allocator_traits<_Alloc> __traits; |
| 593 |
return __traits::select_on_container_copy_construction(__a); |
| 594 |
} |
| 595 |
|
| 596 |
#if __cplusplus < 201703L |
| 597 |
template<typename _Alloc> |
| 598 |
inline void __do_alloc_on_move(_Alloc& __one, _Alloc& __two, true_type) |
| 599 |
{ __one = std::move(__two); } |
| 600 |
|
| 601 |
template<typename _Alloc> |
| 602 |
inline void __do_alloc_on_move(_Alloc&, _Alloc&, false_type) |
| 603 |
{ } |
| 604 |
#endif |
| 605 |
|
| 606 |
template<typename _Alloc> |
| 607 |
_GLIBCXX14_CONSTEXPR inline void |
| 608 |
__alloc_on_move(_Alloc& __one, _Alloc& __two) |
| 609 |
{ |
| 610 |
typedef allocator_traits<_Alloc> __traits; |
| 611 |
typedef typename __traits::propagate_on_container_move_assignment __pocma; |
| 612 |
#if __cplusplus >= 201703L |
| 613 |
if constexpr (__pocma::value) |
| 614 |
__one = std::move(__two); |
| 615 |
#else |
| 616 |
__do_alloc_on_move(__one, __two, __pocma()); |
| 617 |
#endif |
| 618 |
} |
| 619 |
|
| 620 |
#if __cplusplus < 201703L |
| 621 |
template<typename _Alloc> |
| 622 |
inline void __do_alloc_on_swap(_Alloc& __one, _Alloc& __two, true_type) |
| 623 |
{ |
| 624 |
using std::swap; |
| 625 |
swap(__one, __two); |
| 626 |
} |
| 627 |
|
| 628 |
template<typename _Alloc> |
| 629 |
inline void __do_alloc_on_swap(_Alloc&, _Alloc&, false_type) |
| 630 |
{ } |
| 631 |
#endif |
| 632 |
|
| 633 |
template<typename _Alloc> |
| 634 |
_GLIBCXX14_CONSTEXPR inline void |
| 635 |
__alloc_on_swap(_Alloc& __one, _Alloc& __two) |
| 636 |
{ |
| 637 |
typedef allocator_traits<_Alloc> __traits; |
| 638 |
typedef typename __traits::propagate_on_container_swap __pocs; |
| 639 |
#if __cplusplus >= 201703L |
| 640 |
if constexpr (__pocs::value) |
| 641 |
{ |
| 642 |
using std::swap; |
| 643 |
swap(__one, __two); |
| 644 |
} |
| 645 |
#else |
| 646 |
__do_alloc_on_swap(__one, __two, __pocs()); |
| 647 |
#endif |
| 648 |
} |
| 649 |
|
| 650 |
template<typename _Alloc, typename _Tp, |
| 651 |
typename _ValueT = __remove_cvref_t<typename _Alloc::value_type>, |
| 652 |
typename = void> |
| 653 |
struct __is_alloc_insertable_impl |
| 654 |
: false_type |
| 655 |
{ }; |
| 656 |
|
| 657 |
template<typename _Alloc, typename _Tp, typename _ValueT> |
| 658 |
struct __is_alloc_insertable_impl<_Alloc, _Tp, _ValueT, |
| 659 |
__void_t<decltype(allocator_traits<_Alloc>::construct( |
| 660 |
std::declval<_Alloc&>(), std::declval<_ValueT*>(), |
| 661 |
std::declval<_Tp>()))>> |
| 662 |
: true_type |
| 663 |
{ }; |
| 664 |
|
| 665 |
// true if _Alloc::value_type is CopyInsertable into containers using _Alloc |
| 666 |
// (might be wrong if _Alloc::construct exists but is not constrained, |
| 667 |
// i.e. actually trying to use it would still be invalid. Use with caution.) |
| 668 |
template<typename _Alloc> |
| 669 |
struct __is_copy_insertable |
| 670 |
: __is_alloc_insertable_impl<_Alloc, |
| 671 |
typename _Alloc::value_type const&>::type |
| 672 |
{ }; |
| 673 |
|
| 674 |
// std::allocator<_Tp> just requires CopyConstructible |
| 675 |
template<typename _Tp> |
| 676 |
struct __is_copy_insertable<allocator<_Tp>> |
| 677 |
: is_copy_constructible<_Tp> |
| 678 |
{ }; |
| 679 |
|
| 680 |
// true if _Alloc::value_type is MoveInsertable into containers using _Alloc |
| 681 |
// (might be wrong if _Alloc::construct exists but is not constrained, |
| 682 |
// i.e. actually trying to use it would still be invalid. Use with caution.) |
| 683 |
template<typename _Alloc> |
| 684 |
struct __is_move_insertable |
| 685 |
: __is_alloc_insertable_impl<_Alloc, typename _Alloc::value_type>::type |
| 686 |
{ }; |
| 687 |
|
| 688 |
// std::allocator<_Tp> just requires MoveConstructible |
| 689 |
template<typename _Tp> |
| 690 |
struct __is_move_insertable<allocator<_Tp>> |
| 691 |
: is_move_constructible<_Tp> |
| 692 |
{ }; |
| 693 |
|
| 694 |
// Trait to detect Allocator-like types. |
| 695 |
template<typename _Alloc, typename = void> |
| 696 |
struct __is_allocator : false_type { }; |
| 697 |
|
| 698 |
template<typename _Alloc> |
| 699 |
struct __is_allocator<_Alloc, |
| 700 |
__void_t<typename _Alloc::value_type, |
| 701 |
decltype(std::declval<_Alloc&>().allocate(size_t{}))>> |
| 702 |
: true_type { }; |
| 703 |
|
| 704 |
template<typename _Alloc> |
| 705 |
using _RequireAllocator |
| 706 |
= typename enable_if<__is_allocator<_Alloc>::value, _Alloc>::type; |
| 707 |
|
| 708 |
template<typename _Alloc> |
| 709 |
using _RequireNotAllocator |
| 710 |
= typename enable_if<!__is_allocator<_Alloc>::value, _Alloc>::type; |
| 711 |
|
| 712 |
#if __cpp_concepts >= 201907L |
| 713 |
template<typename _Alloc> |
| 714 |
concept __allocator_like = requires (_Alloc& __a) { |
| 715 |
typename _Alloc::value_type; |
| 716 |
__a.deallocate(__a.allocate(1u), 1u); |
| 717 |
}; |
| 718 |
#endif |
| 719 |
#endif // C++11 |
| 720 |
|
| 721 |
/** |
| 722 |
* Destroy a range of objects using the supplied allocator. For |
| 723 |
* non-default allocators we do not optimize away invocation of |
| 724 |
* destroy() even if _Tp has a trivial destructor. |
| 725 |
*/ |
| 726 |
|
| 727 |
template<typename _ForwardIterator, typename _Allocator> |
| 728 |
void |
| 729 |
_Destroy(_ForwardIterator __first, _ForwardIterator __last, |
| 730 |
_Allocator& __alloc) |
| 731 |
{ |
| 732 |
for (; __first != __last; ++__first) |
| 733 |
#if __cplusplus < 201103L |
| 734 |
__alloc.destroy(std::__addressof(*__first)); |
| 735 |
#else |
| 736 |
allocator_traits<_Allocator>::destroy(__alloc, |
| 737 |
std::__addressof(*__first)); |
| 738 |
#endif |
| 739 |
} |
| 740 |
|
| 741 |
template<typename _ForwardIterator, typename _Tp> |
| 742 |
inline void |
| 743 |
_Destroy(_ForwardIterator __first, _ForwardIterator __last, |
| 744 |
allocator<_Tp>&) |
| 745 |
{ |
| 746 |
_Destroy(__first, __last); |
| 747 |
} |
| 748 |
|
| 749 |
_GLIBCXX_END_NAMESPACE_VERSION |
| 750 |
} // namespace std |
| 751 |
#endif // _ALLOC_TRAITS_H |