std::bad_alloc
來自 cppreference.com
| 定義於標頭檔案 <new> |
||
| class bad_alloc; |
||
std::bad_alloc 是由分配函式丟擲的一種異常型別，用於報告儲存分配失敗。
繼承圖
目錄 |
[編輯] 成員函式
| (建構函式) |
構造新的 bad_alloc 物件(公開成員函式) |
| operator= |
替換 bad_alloc 物件(公開成員函式) |
| what |
返回解釋字串 (公開成員函式) |
std::bad_alloc::bad_alloc
| (1) | ||
bad_alloc() throw(); |
(C++11 前) | |
| bad_alloc() noexcept; |
(C++11 起) | |
| (2) | ||
bad_alloc( const bad_alloc& other ) throw(); |
(C++11 前) | |
| bad_alloc( const bad_alloc& other ) noexcept; |
(C++11 起) | |
構造一個新的 bad_alloc 物件，帶有一個實現定義的以 null 結尾的位元組字串，該字串可透過 what() 訪問。
1) 預設建構函式。
2) 複製建構函式。如果 *this 和 other 都具有動態型別
std::bad_alloc，則 std::strcmp(what(), other.what()) == 0。(C++11 起)引數
| 其他 | - | 要複製的另一個異常物件 |
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 起)
引數
| 其他 | - | 用於賦值的另一個異常物件 |
返回值
*this
std::bad_alloc::what
| virtual const char* what() const throw(); |
(C++11 前) | |
virtual const char* what() const noexcept; |
(C++11 起) (C++26 起為 constexpr) |
|
返回解釋字串。
返回值
指向一個實現定義的以 null 結尾的字串，其中包含解釋資訊。該字串適合轉換為 std::wstring 並顯示。保證該指標在獲取它的異常物件被銷燬之前，或在該異常物件上呼叫非 const 成員函式（例如複製賦值運算子）之前始終有效。
|
在常量求值期間，返回的字串使用普通字面量編碼進行編碼。 |
(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
[編輯] 參閱
| 分配函式 (函式) |
