Spec-Zone.ru › C++

Заголовок стандартной библиотеки <new>

Этот заголовок является частью библиотеки управления динамической памятью и, в частности, предоставляет средства низкоуровневого управления памятью.

Классы

bad_alloc
исключение, выбрасываемое при сбое выделения памяти
(класс)
bad_array_new_length
(C++11)
исключение, выбрасываемое при выделении массива с недопустимой длиной
(класс)
align_val_t
(C++17)
тип для передачи выравнивания функциям выделения и освобождения памяти, учитывающим выравнивание
(перечисление)

Типы

new_handler
тип указателя на функцию обработчика new
(псевдоним типа)

Теги

nothrownothrow_t
тег для выбора функции выделения памяти, не выбрасывающей исключения
(тег)
destroying_deletedestroying_delete_t
(C++20)
тег для выбора перегрузок destroying-delete для operator delete
(тег)

Константы

hardware_destructive_interference_sizehardware_constructive_interference_size
(C++17)
минимальное смещение для предотвращения ложного совместного использования
максимальное смещение для содействия истинному совместному использованию
(константа)

Функции

operator newoperator new[]
функции выделения памяти
(функция)
operator deleteoperator delete[]
функции освобождения памяти
(функция)
get_new_handler
(C++11)
получает текущий обработчик new
(функция)
set_new_handler
регистрирует новый обработчик
(функция)
launder
(C++17)
барьер для оптимизации указателей
(шаблон функции)

Обзор

// all freestanding
namespace std {
  // storage allocation errors
  class bad_alloc;
  class bad_array_new_length;

  struct destroying_delete_t
  {
    explicit destroying_delete_t() = default;
  };
  inline constexpr destroying_delete_t destroying_delete{};

  // global operator new control
  enum class align_val_t : size_t
  {
  };

  struct nothrow_t
  {
    explicit nothrow_t() = default;
  };
  extern const nothrow_t nothrow;

  using new_handler = void (*)();
  new_handler get_new_handler() noexcept;
  new_handler set_new_handler(new_handler new_p) noexcept;

  // pointer optimization barrier
  template<class T> constexpr T* launder(T* p) noexcept;

  // hardware interference size
  inline constexpr size_t hardware_destructive_interference_size =
    /* implementation-defined */;
  inline constexpr size_t hardware_constructive_interference_size =
    /* implementation-defined */;
}

// storage allocation and deallocation
void*
operator new(std::size_t size);
void*
operator new(std::size_t size, std::align_val_t alignment);
void*
operator new(std::size_t size, const std::nothrow_t&) noexcept;
void*
operator new(std::size_t size,
             std::align_val_t alignment,
             const std::nothrow_t&) noexcept;

void
operator delete(void* ptr) noexcept;
void
operator delete(void* ptr, std::size_t size) noexcept;
void
operator delete(void* ptr, std::align_val_t alignment) noexcept;
void
operator delete(void* ptr, std::size_t size, std::align_val_t alignment) noexcept;
void
operator delete(void* ptr, const std::nothrow_t&) noexcept;
void
operator delete(void* ptr, std::align_val_t alignment, const std::nothrow_t&) noexcept;

void*
operator new[](std::size_t size);
void*
operator new[](std::size_t size, std::align_val_t alignment);
void*
operator new[](std::size_t size, const std::nothrow_t&) noexcept;
void*
operator new[](std::size_t size,
               std::align_val_t alignment,
               const std::nothrow_t&) noexcept;

void
operator delete[](void* ptr) noexcept;
void
operator delete[](void* ptr, std::size_t size) noexcept;
void
operator delete[](void* ptr, std::align_val_t alignment) noexcept;
void
operator delete[](void* ptr, std::size_t size, std::align_val_t alignment) noexcept;
void
operator delete[](void* ptr, const std::nothrow_t&) noexcept;
void
operator delete[](void* ptr, std::align_val_t alignment, const std::nothrow_t&) noexcept;

constexpr void*
operator new(std::size_t size, void* ptr) noexcept;
constexpr void*
operator new[](std::size_t size, void* ptr) noexcept;
constexpr void
operator delete(void* ptr, void*) noexcept;
constexpr void
operator delete[](void* ptr, void*) noexcept;

© cppreference.com
Licensed under the Creative Commons Attribution-ShareAlike Unported License v3.0.
https://en.cppreference.com/cpp/header/new

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API