]> git.ipfire.org Git - thirdparty/gcc.git/blobdiff - libstdc++-v3/include/bits/stl_uninitialized.h
Update copyright years.
[thirdparty/gcc.git] / libstdc++-v3 / include / bits / stl_uninitialized.h
index 246d5c36d80284498baf754c3719b3572f332e64..d28dafafaae187b081769f20ef422545e9da15d3 100644 (file)
@@ -1,8 +1,6 @@
 // Raw memory manipulators -*- C++ -*-
 
-// Copyright (C) 2001, 2002, 2003, 2004, 2005, 2006, 2007, 2008,
-// 2009, 2010
-// Free Software Foundation, Inc.
+// Copyright (C) 2001-2021 Free Software Foundation, Inc.
 //
 // This file is part of the GNU ISO C++ Library.  This library is free
 // software; you can redistribute it and/or modify it under the
 #ifndef _STL_UNINITIALIZED_H
 #define _STL_UNINITIALIZED_H 1
 
+#if __cplusplus > 201402L
+#include <bits/stl_pair.h>
+#endif
+
+#if __cplusplus >= 201103L
+#include <type_traits>
+#endif
+
+#include <ext/alloc_traits.h>
+
 namespace std _GLIBCXX_VISIBILITY(default)
 {
 _GLIBCXX_BEGIN_NAMESPACE_VERSION
 
+  /** @addtogroup memory
+   *  @{
+   */
+
+  /// @cond undocumented
+
   template<bool _TrivialValueTypes>
     struct __uninitialized_copy
     {
@@ -73,7 +87,7 @@ _GLIBCXX_BEGIN_NAMESPACE_VERSION
          _ForwardIterator __cur = __result;
          __try
            {
-             for (; __first != __last; ++__first, ++__cur)
+             for (; __first != __last; ++__first, (void)++__cur)
                std::_Construct(std::__addressof(*__cur), *__first);
              return __cur;
            }
@@ -95,12 +109,14 @@ _GLIBCXX_BEGIN_NAMESPACE_VERSION
         { return std::copy(__first, __last, __result); }
     };
 
+  /// @endcond
+
   /**
    *  @brief Copies the range [first,last) into result.
-   *  @param  first  An input iterator.
-   *  @param  last   An input iterator.
-   *  @param  result An output iterator.
-   *  @return   result + (first - last)
+   *  @param  __first  An input iterator.
+   *  @param  __last   An input iterator.
+   *  @param  __result An output iterator.
+   *  @return   __result + (__first - __last)
    *
    *  Like copy(), but does not require an initialized output range.
   */
@@ -113,12 +129,28 @@ _GLIBCXX_BEGIN_NAMESPACE_VERSION
        _ValueType1;
       typedef typename iterator_traits<_ForwardIterator>::value_type
        _ValueType2;
+#if __cplusplus < 201103L
+      const bool __assignable = true;
+#else
+      // Trivial types can have deleted copy constructor, but the std::copy
+      // optimization that uses memmove would happily "copy" them anyway.
+      static_assert(is_constructible<_ValueType2, decltype(*__first)>::value,
+         "result type must be constructible from value type of input range");
+
+      typedef typename iterator_traits<_InputIterator>::reference _RefType1;
+      typedef typename iterator_traits<_ForwardIterator>::reference _RefType2;
+      // Trivial types can have deleted assignment, so using std::copy
+      // would be ill-formed. Require assignability before using std::copy:
+      const bool __assignable = is_assignable<_RefType2, _RefType1>::value;
+#endif
 
-      return std::__uninitialized_copy<(__is_trivial(_ValueType1)
-                                       && __is_trivial(_ValueType2))>::
+      return std::__uninitialized_copy<__is_trivial(_ValueType1)
+                                      && __is_trivial(_ValueType2)
+                                      && __assignable>::
        __uninit_copy(__first, __last, __result);
     }
 
+  /// @cond undocumented
 
   template<bool _TrivialValueType>
     struct __uninitialized_fill
@@ -152,11 +184,13 @@ _GLIBCXX_BEGIN_NAMESPACE_VERSION
         { std::fill(__first, __last, __x); }
     };
 
+  /// @endcond
+
   /**
    *  @brief Copies the value x into the range [first,last).
-   *  @param  first  An input iterator.
-   *  @param  last   An input iterator.
-   *  @param  x      The source value.
+   *  @param  __first  An input iterator.
+   *  @param  __last   An input iterator.
+   *  @param  __x      The source value.
    *  @return   Nothing.
    *
    *  Like fill(), but does not require an initialized output range.
@@ -168,25 +202,39 @@ _GLIBCXX_BEGIN_NAMESPACE_VERSION
     {
       typedef typename iterator_traits<_ForwardIterator>::value_type
        _ValueType;
+#if __cplusplus < 201103L
+      const bool __assignable = true;
+#else
+      // Trivial types can have deleted copy constructor, but the std::fill
+      // optimization that uses memmove would happily "copy" them anyway.
+      static_assert(is_constructible<_ValueType, const _Tp&>::value,
+         "result type must be constructible from input type");
+
+      // Trivial types can have deleted assignment, so using std::fill
+      // would be ill-formed. Require assignability before using std::fill:
+      const bool __assignable = is_copy_assignable<_ValueType>::value;
+#endif
 
-      std::__uninitialized_fill<__is_trivial(_ValueType)>::
+      std::__uninitialized_fill<__is_trivial(_ValueType) && __assignable>::
        __uninit_fill(__first, __last, __x);
     }
 
+  /// @cond undocumented
 
   template<bool _TrivialValueType>
     struct __uninitialized_fill_n
     {
       template<typename _ForwardIterator, typename _Size, typename _Tp>
-        static void
+        static _ForwardIterator
         __uninit_fill_n(_ForwardIterator __first, _Size __n,
                        const _Tp& __x)
         {
          _ForwardIterator __cur = __first;
          __try
            {
-             for (; __n > 0; --__n, ++__cur)
+             for (; __n > 0; --__n, (void) ++__cur)
                std::_Construct(std::__addressof(*__cur), __x);
+             return __cur;
            }
          __catch(...)
            {
@@ -200,32 +248,56 @@ _GLIBCXX_BEGIN_NAMESPACE_VERSION
     struct __uninitialized_fill_n<true>
     {
       template<typename _ForwardIterator, typename _Size, typename _Tp>
-        static void
+        static _ForwardIterator
         __uninit_fill_n(_ForwardIterator __first, _Size __n,
                        const _Tp& __x)
-        { std::fill_n(__first, __n, __x); }
+        { return std::fill_n(__first, __n, __x); }
     };
 
+  /// @endcond
+
+   // _GLIBCXX_RESOLVE_LIB_DEFECTS
+   // DR 1339. uninitialized_fill_n should return the end of its range
   /**
    *  @brief Copies the value x into the range [first,first+n).
-   *  @param  first  An input iterator.
-   *  @param  n      The number of copies to make.
-   *  @param  x      The source value.
+   *  @param  __first  An input iterator.
+   *  @param  __n      The number of copies to make.
+   *  @param  __x      The source value.
    *  @return   Nothing.
    *
    *  Like fill_n(), but does not require an initialized output range.
   */
   template<typename _ForwardIterator, typename _Size, typename _Tp>
-    inline void
+    inline _ForwardIterator
     uninitialized_fill_n(_ForwardIterator __first, _Size __n, const _Tp& __x)
     {
       typedef typename iterator_traits<_ForwardIterator>::value_type
        _ValueType;
 
-      std::__uninitialized_fill_n<__is_trivial(_ValueType)>::
+      // Trivial types do not need a constructor to begin their lifetime,
+      // so try to use std::fill_n to benefit from its memmove optimization.
+      // For arbitrary class types and floating point types we can't assume
+      // that __n > 0 and std::__size_to_integer(__n) > 0 are equivalent,
+      // so only use std::fill_n when _Size is already an integral type.
+#if __cplusplus < 201103L
+      const bool __can_fill = __is_integer<_Size>::__value;
+#else
+      // Trivial types can have deleted copy constructor, but the std::fill_n
+      // optimization that uses memmove would happily "copy" them anyway.
+      static_assert(is_constructible<_ValueType, const _Tp&>::value,
+         "result type must be constructible from input type");
+
+      // Trivial types can have deleted assignment, so using std::fill_n
+      // would be ill-formed. Require assignability before using std::fill_n:
+      constexpr bool __can_fill
+       = __and_<is_integral<_Size>, is_copy_assignable<_ValueType>>::value;
+#endif
+      return __uninitialized_fill_n<__is_trivial(_ValueType) && __can_fill>::
        __uninit_fill_n(__first, __n, __x);
     }
 
+  /// @cond undocumented
+
   // Extensions: versions of uninitialized_copy, uninitialized_fill,
   //  and uninitialized_fill_n that take an allocator parameter.
   //  We dispatch back to the standard versions when we're given the
@@ -241,8 +313,9 @@ _GLIBCXX_BEGIN_NAMESPACE_VERSION
       _ForwardIterator __cur = __result;
       __try
        {
-         for (; __first != __last; ++__first, ++__cur)
-           __alloc.construct(std::__addressof(*__cur), *__first);
+         typedef __gnu_cxx::__alloc_traits<_Allocator> __traits;
+         for (; __first != __last; ++__first, (void)++__cur)
+           __traits::construct(__alloc, std::__addressof(*__cur), *__first);
          return __cur;
        }
       __catch(...)
@@ -290,8 +363,9 @@ _GLIBCXX_BEGIN_NAMESPACE_VERSION
       _ForwardIterator __cur = __first;
       __try
        {
+         typedef __gnu_cxx::__alloc_traits<_Allocator> __traits;
          for (; __cur != __last; ++__cur)
-           __alloc.construct(std::__addressof(*__cur), __x);
+           __traits::construct(__alloc, std::__addressof(*__cur), __x);
        }
       __catch(...)
        {
@@ -308,15 +382,17 @@ _GLIBCXX_BEGIN_NAMESPACE_VERSION
 
   template<typename _ForwardIterator, typename _Size, typename _Tp,
           typename _Allocator>
-    void
+    _ForwardIterator
     __uninitialized_fill_n_a(_ForwardIterator __first, _Size __n, 
                             const _Tp& __x, _Allocator& __alloc)
     {
       _ForwardIterator __cur = __first;
       __try
        {
-         for (; __n > 0; --__n, ++__cur)
-           __alloc.construct(std::__addressof(*__cur), __x);
+         typedef __gnu_cxx::__alloc_traits<_Allocator> __traits;
+         for (; __n > 0; --__n, (void) ++__cur)
+           __traits::construct(__alloc, std::__addressof(*__cur), __x);
+         return __cur;
        }
       __catch(...)
        {
@@ -327,10 +403,10 @@ _GLIBCXX_BEGIN_NAMESPACE_VERSION
 
   template<typename _ForwardIterator, typename _Size, typename _Tp,
           typename _Tp2>
-    inline void
+    inline _ForwardIterator
     __uninitialized_fill_n_a(_ForwardIterator __first, _Size __n, 
                             const _Tp& __x, allocator<_Tp2>&)
-    { std::uninitialized_fill_n(__first, __n, __x); }
+    { return std::uninitialized_fill_n(__first, __n, __x); }
 
 
   // Extensions: __uninitialized_copy_move, __uninitialized_move_copy,
@@ -441,7 +517,11 @@ _GLIBCXX_BEGIN_NAMESPACE_VERSION
        }
     }
 
-#ifdef __GXX_EXPERIMENTAL_CXX0X__
+  /// @endcond
+
+#if __cplusplus >= 201103L
+  /// @cond undocumented
+
   // Extensions: __uninitialized_default, __uninitialized_default_n,
   // __uninitialized_default_a, __uninitialized_default_n_a.
 
@@ -473,10 +553,14 @@ _GLIBCXX_BEGIN_NAMESPACE_VERSION
         static void
         __uninit_default(_ForwardIterator __first, _ForwardIterator __last)
         {
-         typedef typename iterator_traits<_ForwardIterator>::value_type
-           _ValueType;
+         if (__first == __last)
+           return;
 
-         std::fill(__first, __last, _ValueType());
+         typename iterator_traits<_ForwardIterator>::value_type* __val
+           = std::__addressof(*__first);
+         std::_Construct(__val);
+         if (++__first != __last)
+           std::fill(__first, __last, *__val);
        }
     };
 
@@ -484,14 +568,15 @@ _GLIBCXX_BEGIN_NAMESPACE_VERSION
     struct __uninitialized_default_n_1
     {
       template<typename _ForwardIterator, typename _Size>
-        static void
+        static _ForwardIterator
         __uninit_default_n(_ForwardIterator __first, _Size __n)
         {
          _ForwardIterator __cur = __first;
          __try
            {
-             for (; __n > 0; --__n, ++__cur)
+             for (; __n > 0; --__n, (void) ++__cur)
                std::_Construct(std::__addressof(*__cur));
+             return __cur;
            }
          __catch(...)
            {
@@ -505,19 +590,23 @@ _GLIBCXX_BEGIN_NAMESPACE_VERSION
     struct __uninitialized_default_n_1<true>
     {
       template<typename _ForwardIterator, typename _Size>
-        static void
+        static _ForwardIterator
         __uninit_default_n(_ForwardIterator __first, _Size __n)
         {
-         typedef typename iterator_traits<_ForwardIterator>::value_type
-           _ValueType;
-
-         std::fill_n(__first, __n, _ValueType());
+         if (__n > 0)
+           {
+             typename iterator_traits<_ForwardIterator>::value_type* __val
+               = std::__addressof(*__first);
+             std::_Construct(__val);
+             ++__first;
+             __first = std::fill_n(__first, __n - 1, *__val);
+           }
+         return __first;
        }
     };
 
   // __uninitialized_default
-  // Fills [first, last) with std::distance(first, last) default
-  // constructed value_types(s).
+  // Fills [first, last) with value-initialized value_types.
   template<typename _ForwardIterator>
     inline void
     __uninitialized_default(_ForwardIterator __first,
@@ -525,28 +614,35 @@ _GLIBCXX_BEGIN_NAMESPACE_VERSION
     {
       typedef typename iterator_traits<_ForwardIterator>::value_type
        _ValueType;
+      // trivial types can have deleted assignment
+      const bool __assignable = is_copy_assignable<_ValueType>::value;
 
-      std::__uninitialized_default_1<__is_trivial(_ValueType)>::
+      std::__uninitialized_default_1<__is_trivial(_ValueType)
+                                    && __assignable>::
        __uninit_default(__first, __last);
     }
 
   // __uninitialized_default_n
-  // Fills [first, first + n) with n default constructed value_type(s).
+  // Fills [first, first + n) with value-initialized value_types.
   template<typename _ForwardIterator, typename _Size>
-    inline void
+    inline _ForwardIterator
     __uninitialized_default_n(_ForwardIterator __first, _Size __n)
     {
       typedef typename iterator_traits<_ForwardIterator>::value_type
        _ValueType;
+      // See uninitialized_fill_n for the conditions for using std::fill_n.
+      constexpr bool __can_fill
+       = __and_<is_integral<_Size>, is_copy_assignable<_ValueType>>::value;
 
-      std::__uninitialized_default_n_1<__is_trivial(_ValueType)>::
+      return __uninitialized_default_n_1<__is_trivial(_ValueType)
+                                        && __can_fill>::
        __uninit_default_n(__first, __n);
     }
 
 
   // __uninitialized_default_a
-  // Fills [first, last) with std::distance(first, last) default
-  // constructed value_types(s), constructed with the allocator alloc.
+  // Fills [first, last) with value_types constructed by the allocator
+  // alloc, with no arguments passed to the construct call.
   template<typename _ForwardIterator, typename _Allocator>
     void
     __uninitialized_default_a(_ForwardIterator __first,
@@ -556,8 +652,9 @@ _GLIBCXX_BEGIN_NAMESPACE_VERSION
       _ForwardIterator __cur = __first;
       __try
        {
+         typedef __gnu_cxx::__alloc_traits<_Allocator> __traits;
          for (; __cur != __last; ++__cur)
-           __alloc.construct(std::__addressof(*__cur));
+           __traits::construct(__alloc, std::__addressof(*__cur));
        }
       __catch(...)
        {
@@ -575,18 +672,20 @@ _GLIBCXX_BEGIN_NAMESPACE_VERSION
 
 
   // __uninitialized_default_n_a
-  // Fills [first, first + n) with n default constructed value_types(s),
-  // constructed with the allocator alloc.
+  // Fills [first, first + n) with value_types constructed by the allocator
+  // alloc, with no arguments passed to the construct call.
   template<typename _ForwardIterator, typename _Size, typename _Allocator>
-    void
+    _ForwardIterator
     __uninitialized_default_n_a(_ForwardIterator __first, _Size __n, 
                                _Allocator& __alloc)
     {
       _ForwardIterator __cur = __first;
       __try
        {
-         for (; __n > 0; --__n, ++__cur)
-           __alloc.construct(std::__addressof(*__cur));
+         typedef __gnu_cxx::__alloc_traits<_Allocator> __traits;
+         for (; __n > 0; --__n, (void) ++__cur)
+           __traits::construct(__alloc, std::__addressof(*__cur));
+         return __cur;
        }
       __catch(...)
        {
@@ -595,12 +694,106 @@ _GLIBCXX_BEGIN_NAMESPACE_VERSION
        }
     }
 
+  // __uninitialized_default_n_a specialization for std::allocator,
+  // which ignores the allocator and value-initializes the elements.
   template<typename _ForwardIterator, typename _Size, typename _Tp>
-    inline void
+    inline _ForwardIterator
     __uninitialized_default_n_a(_ForwardIterator __first, _Size __n, 
                                allocator<_Tp>&)
-    { std::__uninitialized_default_n(__first, __n); }
+    { return std::__uninitialized_default_n(__first, __n); }
+
+  template<bool _TrivialValueType>
+    struct __uninitialized_default_novalue_1
+    {
+      template<typename _ForwardIterator>
+       static void
+       __uninit_default_novalue(_ForwardIterator __first,
+                                _ForwardIterator __last)
+       {
+         _ForwardIterator __cur = __first;
+         __try
+           {
+             for (; __cur != __last; ++__cur)
+               std::_Construct_novalue(std::__addressof(*__cur));
+           }
+         __catch(...)
+           {
+             std::_Destroy(__first, __cur);
+             __throw_exception_again;
+           }
+       }
+    };
+
+  template<>
+    struct __uninitialized_default_novalue_1<true>
+    {
+      template<typename _ForwardIterator>
+        static void
+        __uninit_default_novalue(_ForwardIterator __first,
+                                _ForwardIterator __last)
+       {
+       }
+    };
+
+  template<bool _TrivialValueType>
+    struct __uninitialized_default_novalue_n_1
+    {
+      template<typename _ForwardIterator, typename _Size>
+       static _ForwardIterator
+       __uninit_default_novalue_n(_ForwardIterator __first, _Size __n)
+       {
+         _ForwardIterator __cur = __first;
+         __try
+           {
+             for (; __n > 0; --__n, (void) ++__cur)
+               std::_Construct_novalue(std::__addressof(*__cur));
+             return __cur;
+           }
+         __catch(...)
+           {
+             std::_Destroy(__first, __cur);
+             __throw_exception_again;
+           }
+       }
+    };
 
+  template<>
+    struct __uninitialized_default_novalue_n_1<true>
+    {
+      template<typename _ForwardIterator, typename _Size>
+       static _ForwardIterator
+       __uninit_default_novalue_n(_ForwardIterator __first, _Size __n)
+       { return std::next(__first, __n); }
+    };
+
+  // __uninitialized_default_novalue
+  // Fills [first, last) with default-initialized value_types.
+  template<typename _ForwardIterator>
+    inline void
+    __uninitialized_default_novalue(_ForwardIterator __first,
+                                   _ForwardIterator __last)
+    {
+      typedef typename iterator_traits<_ForwardIterator>::value_type
+       _ValueType;
+
+      std::__uninitialized_default_novalue_1<
+       is_trivially_default_constructible<_ValueType>::value>::
+       __uninit_default_novalue(__first, __last);
+    }
+
+  // __uninitialized_default_novalue_n
+  // Fills [first, first + n) with default-initialized value_types.
+  template<typename _ForwardIterator, typename _Size>
+    inline _ForwardIterator
+    __uninitialized_default_novalue_n(_ForwardIterator __first, _Size __n)
+    {
+      typedef typename iterator_traits<_ForwardIterator>::value_type
+       _ValueType;
+
+      return __uninitialized_default_novalue_n_1<
+       is_trivially_default_constructible<_ValueType>::value>::
+       __uninit_default_novalue_n(__first, __n);
+    }
 
   template<typename _InputIterator, typename _Size,
           typename _ForwardIterator>
@@ -611,7 +804,7 @@ _GLIBCXX_BEGIN_NAMESPACE_VERSION
       _ForwardIterator __cur = __result;
       __try
        {
-         for (; __n > 0; --__n, ++__first, ++__cur)
+         for (; __n > 0; --__n, (void) ++__first, ++__cur)
            std::_Construct(std::__addressof(*__cur), *__first);
          return __cur;
        }
@@ -630,12 +823,46 @@ _GLIBCXX_BEGIN_NAMESPACE_VERSION
                           random_access_iterator_tag)
     { return std::uninitialized_copy(__first, __first + __n, __result); }
 
+  template<typename _InputIterator, typename _Size,
+          typename _ForwardIterator>
+    pair<_InputIterator, _ForwardIterator>
+    __uninitialized_copy_n_pair(_InputIterator __first, _Size __n,
+                          _ForwardIterator __result, input_iterator_tag)
+    {
+      _ForwardIterator __cur = __result;
+      __try
+       {
+         for (; __n > 0; --__n, (void) ++__first, ++__cur)
+           std::_Construct(std::__addressof(*__cur), *__first);
+         return {__first, __cur};
+       }
+      __catch(...)
+       {
+         std::_Destroy(__result, __cur);
+         __throw_exception_again;
+       }
+    }
+
+  template<typename _RandomAccessIterator, typename _Size,
+          typename _ForwardIterator>
+    inline pair<_RandomAccessIterator, _ForwardIterator>
+    __uninitialized_copy_n_pair(_RandomAccessIterator __first, _Size __n,
+                          _ForwardIterator __result,
+                          random_access_iterator_tag)
+    {
+      auto __second_res = uninitialized_copy(__first, __first + __n, __result);
+      auto __first_res = std::next(__first, __n);
+      return {__first_res, __second_res};
+    }
+
+  /// @endcond
+
   /**
    *  @brief Copies the range [first,first+n) into result.
-   *  @param  first  An input iterator.
-   *  @param  n      The number of elements to copy.
-   *  @param  result An output iterator.
-   *  @return  result + n
+   *  @param  __first  An input iterator.
+   *  @param  __n      The number of elements to copy.
+   *  @param  __result An output iterator.
+   *  @return  __result + __n
    *
    *  Like copy_n(), but does not require an initialized output range.
   */
@@ -645,8 +872,186 @@ _GLIBCXX_BEGIN_NAMESPACE_VERSION
                         _ForwardIterator __result)
     { return std::__uninitialized_copy_n(__first, __n, __result,
                                         std::__iterator_category(__first)); }
+
+  /// @cond undocumented
+  template<typename _InputIterator, typename _Size, typename _ForwardIterator>
+    inline pair<_InputIterator, _ForwardIterator>
+    __uninitialized_copy_n_pair(_InputIterator __first, _Size __n,
+                             _ForwardIterator __result)
+    {
+      return
+       std::__uninitialized_copy_n_pair(__first, __n, __result,
+                                        std::__iterator_category(__first));
+    }
+  /// @endcond
 #endif
 
+#if __cplusplus >= 201703L
+# define __cpp_lib_raw_memory_algorithms 201606L
+
+  /**
+   *  @brief Default-initializes objects in the range [first,last).
+   *  @param  __first  A forward iterator.
+   *  @param  __last   A forward iterator.
+  */
+  template <typename _ForwardIterator>
+    inline void
+    uninitialized_default_construct(_ForwardIterator __first,
+                                   _ForwardIterator __last)
+    {
+      __uninitialized_default_novalue(__first, __last);
+    }
+
+  /**
+   *  @brief Default-initializes objects in the range [first,first+count).
+   *  @param  __first  A forward iterator.
+   *  @param  __count  The number of objects to construct.
+   *  @return   __first + __count
+  */
+  template <typename _ForwardIterator, typename _Size>
+    inline _ForwardIterator
+    uninitialized_default_construct_n(_ForwardIterator __first, _Size __count)
+    {
+      return __uninitialized_default_novalue_n(__first, __count);
+    }
+
+  /**
+   *  @brief Value-initializes objects in the range [first,last).
+   *  @param  __first  A forward iterator.
+   *  @param  __last   A forward iterator.
+  */
+  template <typename _ForwardIterator>
+    inline void
+    uninitialized_value_construct(_ForwardIterator __first,
+                                 _ForwardIterator __last)
+    {
+      return __uninitialized_default(__first, __last);
+    }
+
+  /**
+   *  @brief Value-initializes objects in the range [first,first+count).
+   *  @param  __first  A forward iterator.
+   *  @param  __count  The number of objects to construct.
+   *  @return   __result + __count
+  */
+  template <typename _ForwardIterator, typename _Size>
+    inline _ForwardIterator
+    uninitialized_value_construct_n(_ForwardIterator __first, _Size __count)
+    {
+      return __uninitialized_default_n(__first, __count);
+    }
+
+  /**
+   *  @brief Move-construct from the range [first,last) into result.
+   *  @param  __first  An input iterator.
+   *  @param  __last   An input iterator.
+   *  @param  __result An output iterator.
+   *  @return   __result + (__first - __last)
+  */
+  template <typename _InputIterator, typename _ForwardIterator>
+    inline _ForwardIterator
+    uninitialized_move(_InputIterator __first, _InputIterator __last,
+                      _ForwardIterator __result)
+    {
+      return std::uninitialized_copy
+       (_GLIBCXX_MAKE_MOVE_ITERATOR(__first),
+        _GLIBCXX_MAKE_MOVE_ITERATOR(__last), __result);
+    }
+
+  /**
+   *  @brief Move-construct from the range [first,first+count) into result.
+   *  @param  __first  An input iterator.
+   *  @param  __count  The number of objects to initialize.
+   *  @param  __result An output iterator.
+   *  @return  __result + __count
+  */
+  template <typename _InputIterator, typename _Size, typename _ForwardIterator>
+    inline pair<_InputIterator, _ForwardIterator>
+    uninitialized_move_n(_InputIterator __first, _Size __count,
+                        _ForwardIterator __result)
+    {
+      auto __res = std::__uninitialized_copy_n_pair
+       (_GLIBCXX_MAKE_MOVE_ITERATOR(__first),
+        __count, __result);
+      return {__res.first.base(), __res.second};
+    }
+#endif // C++17
+
+#if __cplusplus >= 201103L
+  /// @cond undocumented
+
+  template<typename _Tp, typename _Up, typename _Allocator>
+    inline void
+    __relocate_object_a(_Tp* __restrict __dest, _Up* __restrict __orig,
+                       _Allocator& __alloc)
+    noexcept(noexcept(std::allocator_traits<_Allocator>::construct(__alloc,
+                        __dest, std::move(*__orig)))
+            && noexcept(std::allocator_traits<_Allocator>::destroy(
+                           __alloc, std::__addressof(*__orig))))
+    {
+      typedef std::allocator_traits<_Allocator> __traits;
+      __traits::construct(__alloc, __dest, std::move(*__orig));
+      __traits::destroy(__alloc, std::__addressof(*__orig));
+    }
+
+  // This class may be specialized for specific types.
+  // Also known as is_trivially_relocatable.
+  template<typename _Tp, typename = void>
+    struct __is_bitwise_relocatable
+    : is_trivial<_Tp> { };
+
+  template <typename _Tp, typename _Up>
+    inline __enable_if_t<std::__is_bitwise_relocatable<_Tp>::value, _Tp*>
+    __relocate_a_1(_Tp* __first, _Tp* __last,
+                  _Tp* __result, allocator<_Up>&) noexcept
+    {
+      ptrdiff_t __count = __last - __first;
+      if (__count > 0)
+       __builtin_memmove(__result, __first, __count * sizeof(_Tp));
+      return __result + __count;
+    }
+
+  template <typename _InputIterator, typename _ForwardIterator,
+           typename _Allocator>
+    inline _ForwardIterator
+    __relocate_a_1(_InputIterator __first, _InputIterator __last,
+                  _ForwardIterator __result, _Allocator& __alloc)
+    noexcept(noexcept(std::__relocate_object_a(std::addressof(*__result),
+                                              std::addressof(*__first),
+                                              __alloc)))
+    {
+      typedef typename iterator_traits<_InputIterator>::value_type
+       _ValueType;
+      typedef typename iterator_traits<_ForwardIterator>::value_type
+       _ValueType2;
+      static_assert(std::is_same<_ValueType, _ValueType2>::value,
+         "relocation is only possible for values of the same type");
+      _ForwardIterator __cur = __result;
+      for (; __first != __last; ++__first, (void)++__cur)
+       std::__relocate_object_a(std::__addressof(*__cur),
+                                std::__addressof(*__first), __alloc);
+      return __cur;
+    }
+
+  template <typename _InputIterator, typename _ForwardIterator,
+           typename _Allocator>
+    inline _ForwardIterator
+    __relocate_a(_InputIterator __first, _InputIterator __last,
+                _ForwardIterator __result, _Allocator& __alloc)
+    noexcept(noexcept(__relocate_a_1(std::__niter_base(__first),
+                                    std::__niter_base(__last),
+                                    std::__niter_base(__result), __alloc)))
+    {
+      return __relocate_a_1(std::__niter_base(__first),
+                           std::__niter_base(__last),
+                           std::__niter_base(__result), __alloc);
+    }
+
+  /// @endcond
+#endif
+
+  // @} group memory
+
 _GLIBCXX_END_NAMESPACE_VERSION
 } // namespace