ext/new_allocator.h

Go to the documentation of this file.

// Allocator that wraps operator new -*- C++ -*-
 
// Copyright (C) 2001-2025 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
// terms of the GNU General Public License as published by the
// Free Software Foundation; either version 3, or (at your option)
// any later version.
 
// This library is distributed in the hope that it will be useful,
// but WITHOUT ANY WARRANTY; without even the implied warranty of
// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
// GNU General Public License for more details.
 
// Under Section 7 of GPL version 3, you are granted additional
// permissions described in the GCC Runtime Library Exception, version
// 3.1, as published by the Free Software Foundation.
 
// You should have received a copy of the GNU General Public License and
// a copy of the GCC Runtime Library Exception along with this program;
// see the files COPYING3 and COPYING.RUNTIME respectively.  If not, see
// <http://www.gnu.org/licenses/>.
 
/** @file ext/new_allocator.h
 *  This file is a GNU extension to the Standard C++ Library.
 */
 
#ifndef _NEW_ALLOCATOR_H
#define _NEW_ALLOCATOR_H 1
 
#include <bits/requires_hosted.h> // GNU extensions are currently omitted
 
#include <bits/new_allocator.h>
 
namespace __gnu_cxx _GLIBCXX_VISIBILITY(default)
{
_GLIBCXX_BEGIN_NAMESPACE_VERSION
 
  /**
   *  @brief  An allocator that uses global `new`, as per C++03 [20.4.1].
   *  @ingroup allocators
   *
   *  This is precisely the allocator defined in the C++ Standard.
   *    - all allocation calls `operator new`
   *    - all deallocation calls `operator delete`
   *
   *  This is a non-standard extension that can be used to guarantee
   *  allocation from `new` even if the library has been configured to
   *  use a different implementation for `std::allocator`.
   *
   *  @tparam  _Tp  Type of allocated object.
   *
   *  @headerfile ext/new_allocator.h
   */
  template<typename _Tp>
    class new_allocator : public std::__new_allocator<_Tp>
    {
    public:
#if __cplusplus <= 201703L
      template<typename _Tp1>
        struct rebind
        { typedef new_allocator<_Tp1> other; };
#endif
 
      new_allocator() _GLIBCXX_USE_NOEXCEPT { }
 
      new_allocator(const new_allocator&) _GLIBCXX_USE_NOEXCEPT { }
 
      template<typename _Tp1>
        new_allocator(const new_allocator<_Tp1>&) _GLIBCXX_USE_NOEXCEPT { }
    };
 
_GLIBCXX_END_NAMESPACE_VERSION
} // namespace
 
#endif