std::invalid_argument

定義於標頭檔案 `<stdexcept>`
class invalid_argument;

定義一種作為異常丟擲的物件型別。它報告由於引數值不被接受而產生的錯誤。

此異常由 std::bitset::bitset 以及 std::stoi 和 std::stof 函式家族丟擲。

繼承圖

std::invalid_argument::invalid_argument

invalid_argument( const std::string& what_arg );	(1)
invalid_argument( const char* what_arg );	(2)
invalid_argument( const invalid_argument& other );	(3)	(C++11 起無異常丟擲)

1) 構造異常物件，以 what_arg 作為解釋性字串。構造後，std::strcmp(what(), what_arg.c_str()) == 0。

2) 構造異常物件，以 what_arg 作為解釋性字串。構造後，std::strcmp(what(), what_arg) == 0。

3) 複製建構函式。如果 *this 和 other 都具有動態型別 std::invalid_argument，則 std::strcmp(what(), other.what()) == 0。複製建構函式不能丟擲異常。

引數

what_arg	-	解釋性字串
其他	-	要複製的另一個異常物件

異常

1,2) 可能丟擲 std::bad_alloc。

注意

因為複製 std::invalid_argument 不允許丟擲異常，所以此訊息通常在內部作為單獨分配的引用計數字符串儲存。這也是為什麼沒有接受 std::string&& 的建構函式：無論如何它都必須複製內容。

在 LWG issue 254 解決之前，非複製建構函式只能接受 std::string。它使得動態分配成為強制性，以便構造 std::string 物件。

在 LWG issue 471 解決之後，派生標準異常類必須具有公開可訪問的複製建構函式。只要透過 what() 獲取的解釋性字串對於原始物件和複製物件相同，就可以隱式定義它。

std::invalid_argument::operator=

invalid_argument& operator=( const invalid_argument& other );		(C++11 起無異常丟擲)

用 other 的內容賦值。如果 *this 和 other 都具有動態型別 std::invalid_argument，則賦值後 std::strcmp(what(), other.what()) == 0。複製賦值運算子不能丟擲異常。

引數

其他

-

用於賦值的另一個異常物件

返回值

*this

注意

在 LWG issue 471 解決之後，派生標準異常類必須具有公開可訪問的複製賦值運算子。只要透過 what() 獲取的解釋性字串對於原始物件和複製物件相同，就可以隱式定義它。

繼承自 std::logic_error

繼承自 std::exception

成員函式

(解構函式) [virtual]	銷燬異常物件 (`std::exception` 的虛公共成員函式) [編輯]
what [virtual]	返回解釋字串 (`std::exception` 的虛公共成員函式) [編輯]

[編輯] 註釋

此異常型別的目的類似於錯誤條件 std::errc::invalid_argument（由 std::thread 的成員函式在 std::system_error 中丟擲）和相關的 errno 常量 EINVAL。

[編輯] 示例

執行此程式碼

#include <bitset>
#include <iostream>
#include <stdexcept>
#include <string>
 
int main()
{
    try
    {
        std::bitset<4>{"012"}; // Throws: only '0' or '1' expected
    }
    catch (std::invalid_argument const& ex)
    {
        std::cout << "#1: " << ex.what() << '\n';
    }
 
    try
    {
        [[maybe_unused]] int f = std::stoi("ABBA"); // Throws: no conversion
    }
    catch (std::invalid_argument const& ex)
    {
        std::cout << "#2: " << ex.what() << '\n';
    }
 
    try
    {
        [[maybe_unused]] float f = std::stof("(3.14)"); // Throws: no conversion
    }
    catch (std::invalid_argument const& ex)
    {
        std::cout << "#3: " << ex.what() << '\n';
    }
}

可能的輸出

#1: bitset string ctor has invalid argument
#2: stoi: no conversion
#3: stof: no conversion

[編輯] 缺陷報告

下列更改行為的缺陷報告追溯地應用於以前出版的 C++ 標準。

缺陷報告	應用於	釋出時的行為	正確的行為
LWG 254	C++98	缺少接受 const char* 的建構函式	已新增
LWG 471	C++98	`std::invalid_argument` 的解釋性字串解釋性字串是實現定義的	它們與原始 `std::runtime_error` 物件的原始的 `std::invalid_argument` 物件

編譯器支援
自由（freestanding）與宿主（hosted）
語言
標準庫
標準庫標頭檔案
具名要求
特性測試宏 (C++20)
語言支援庫
概念庫 (C++20)
診斷庫
記憶體管理庫
超程式設計庫 (C++11)
通用工具庫
容器庫
迭代器庫
範圍庫 (C++20)
演算法庫
字串庫
文字處理庫
數值庫
日期和時間庫
輸入/輸出庫
檔案系統庫 (C++17)
併發支援庫 (C++11)
執行控制庫 (C++26)
技術規範
符號索引
外部庫

(建構函式)	構造一個新的帶給定訊息的 `invalid_argument` 物件 (公開成員函式)
operator=	替換 `invalid_argument` 物件 (公開成員函式)

cppreference.com

名稱空間

變體

檢視

操作