std::bad_alloc
| Определено в заголовке <new>
|
||
class bad_alloc;
|
||
std::bad_alloc это тип объекта, выбрасываемого в качестве исключения функциями распределения для сообщения об ошибке выделения памяти.
Диаграмма наследования
Функции-члены
|
(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()
.
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) | |
Присваивает содержимое, копируя его из 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
Смотрите также
|
функции выделения памяти
(функция) |