std::bad_variant_access

来自cppreference.com
< cpp‎ | utility‎ | variant
 
C++
 
工具库
通用工具
关系运算符 (C++20 弃用)
 
std::variant
 
在标头 <variant> 定义
class bad_variant_access : public std::exception
 (C++17 起)

std::bad_variant_access 是下列情形中抛出的异常的类型：

(C++26 起)

目录

[编辑] 成员函数

(构造函数)
 构造新的 bad_variant_access 对象
(公开成员函数)
operator=
 替换 bad_variant_access 对象
(公开成员函数)
what
 返回解释字符串
(公开成员函数)

std::bad_variant_access::bad_variant_access

bad_variant_access() noexcept;
 (1) (C++17 起)
bad_variant_access( const bad_variant_access& other ) noexcept;
 (2) (C++17 起)

构造新的拥有实现定义的空终止字节字符串的 bad_variant_access 对象，字符串能通过 what() 访问。

1) 默认构造函数。
2) 复制构造函数。如果 *this 与 other 均拥有动态类型 std::bad_variant_access，那么 std::strcmp(what(), other.what()) == 0。

参数

other - 要复制的另一异常对象

std::bad_variant_access::operator=

bad_variant_access& operator=( const bad_variant_access& other ) noexcept;
 (C++17 起)

以 other 的内容赋值。如果 *this 与 other 均拥有动态类型 std::bad_variant_access，那么赋值后 std::strcmp(what(), other.what()) == 0。

参数

other - 用来赋值的另一异常对象

返回值

*this

std::bad_variant_access::what

virtual const char* what() const noexcept;
 (C++17 起)

返回解释字符串。

返回值

指向有由实现定义的解释信息的空终止字符串的指针。该字符串适合转换并显示为 std::wstring。保证该指针至少直到获得它来源的异常对象被销毁，或在该异常对象上调用非 const 成员函数（例如复制赋值运算符）为止一直有效。

返回的字符串在常量求值过程中按普通字面量编码。

(C++26 起)

注解

允许但不要求实现覆写 what()。

继承自 std::exception

成员函数

[虚]
 销毁该异常对象
(std::exception 的虚公开成员函数) [编辑]
[虚]
 返回解释性字符串
(std::exception 的虚公开成员函数) [编辑]

[编辑] 示例

运行此代码
#include <iostream>
#include <variant>
 
int main()
{
    std::variant<int, float> v;
    v = 12;
    try
    {
        std::get<float>(v);
    }
    catch(const std::bad_variant_access& e)
    {
        std::cout << e.what() << '\n';
    }
}

可能的输出： 

bad_variant_access

[编辑] 参阅

(C++17)
 以给定索引或类型（如果类型唯一）读取 variant 的值，错误时抛出异常
(函数模板) [编辑]
(C++17)
 以一或多个 variant 所保有的各实参调用所提供的函数对象
(函数模板) [编辑]
(C++26)
 以 variant 所保有的实参调用提供的函数对象
(公开成员函数) [编辑]
来自“https://zh.cppreference.com/mwiki/index.php?title=cpp/utility/variant/bad_variant_access&oldid=99649”