Namespaces
Variants

std:: bad_alloc

From cppreference.net
< cpp ‎ | memory ‎ | new
C++
Utilities library
Memory management library
( exposition only* )
Allocators
Uninitialized memory algorithms
Constrained uninitialized memory algorithms
Memory resources
Uninitialized storage (until C++20)
( until C++20* )
( until C++20* )
( until C++20* )

Garbage collector support (until C++23)
(C++11) (until C++23)
(C++11) (until C++23)
(C++11) (until C++23)
(C++11) (until C++23)
(C++11) (until C++23)
(C++11) (until C++23)
Low level memory management
Определено в заголовочном файле <new>
class bad_alloc : public std:: exception

std::bad_alloc — это тип объекта, выбрасываемого в качестве исключения функциями выделения памяти для сообщения о неудаче при выделении памяти.

cpp/error/exception std-bad alloc-inheritance.svg

Диаграмма наследования

Содержание

Функции-члены

(constructor)
создает новый объект bad_alloc
(public member function)
operator=
заменяет объект bad_alloc
(public member function)
what
возвращает поясняющую строку
(public member function)

std::bad_alloc:: bad_alloc

(1)
bad_alloc ( ) throw ( ) ;
(до C++11)
bad_alloc ( ) noexcept ;
(начиная с C++11)
(constexpr начиная с C++26)
(2)
bad_alloc ( const bad_alloc & other ) throw ( ) ;
(до C++11)
bad_alloc ( const bad_alloc & other ) noexcept ;
(начиная с C++11)
(constexpr начиная с C++26)

Создает новый объект bad_alloc с реализационно-определенной строкой байтов с нулевым завершением, доступной через what() .

1) Конструктор по умолчанию.
2) Конструктор копирования. Если * this и other оба имеют динамический тип std::bad_alloc , то std:: strcmp ( what ( ) , other. what ( ) ) == 0 . (начиная с C++11)

Параметры

other - другой объект исключения для копирования

std::bad_alloc:: operator=

bad_alloc & operator = ( const bad_alloc & other ) throw ( ) ;
(до C++11)
bad_alloc & operator = ( const bad_alloc & other ) noexcept ;
(начиная с C++11)
(constexpr начиная с C++26)

Присваивает содержимое из other . Если * this и other оба имеют динамический тип std::bad_alloc , то std:: strcmp ( what ( ) , other. what ( ) ) == 0 после присваивания. (начиная с C++11)

Параметры

other - другой объект исключения для присваивания

Возвращаемое значение

* this

std::bad_alloc:: what

virtual const char * what ( ) const throw ( ) ;
(до C++11)
virtual const char * what ( ) const noexcept ;
(начиная с C++11)
(constexpr начиная с C++26)

Возвращает пояснительную строку.

Возвращаемое значение

Указатель на определенную реализацией нуль-терминированную строку с пояснительной информацией. Строка подходит для преобразования и отображения как std::wstring . Гарантируется, что указатель остается действительным по крайней мере до тех пор, пока не будет уничтожен объект исключения, из которого он получен, или пока не будет вызвана неконстантная функция-член (например, оператор присваивания копированием) для объекта исключения.

Возвращаемая строка кодируется с использованием обычной кодировки литералов во время константной оценки.

(начиная с C++26)

Примечания

Реализациям разрешено, но не требуется, переопределять what() .

Унаследовано от std:: exception

Функции-члены

[virtual]
уничтожает объект исключения
(виртуальная публичная функция-член std::exception )
[virtual]
возвращает поясняющую строку
(виртуальная публичная функция-член std::exception )

Примечания

Макрос тестирования возможностей Значение Стандарт Возможность
__cpp_lib_constexpr_exceptions 202411L (C++26) constexpr для типов исключений

Пример

Запустить этот код 
#include <iostream>
#include <new>
int main()
{
    try
    {
        while (true)
        {
            new int[100000000ul];
        }
    }
    catch (const std::bad_alloc& e)
    {
        std::cout << "Allocation failed: " << e.what() << '\n';
    }
}

Возможный вывод: 

Allocation failed: std::bad_alloc

Смотрите также

функции выделения памяти
(функция)