std::any
来自 cppreference.com
定义在头文件 <any> 中 |
||
class any; |
(自 C++17 起) | |
类 any
描述了一个类型安全的容器,用于保存任何 可复制构造 类型的单个值。
1) 类
any
的对象存储任何满足构造函数要求的类型的实例,或者为空,这被称为类 any
对象的状态。存储的实例称为包含对象。如果两个状态都为空,或者如果两个状态都不为空,并且包含对象是等价的,则这两个状态是等价的。2) 非成员
any_cast
函数提供对包含对象的类型安全访问。鼓励实现避免对小型对象进行动态分配,但这种优化可能只适用于 std::is_nothrow_move_constructible 返回 true
的类型。
内容 |
[编辑] 成员函数
构造一个 any 对象(公共成员函数) | |
分配一个 any 对象(公共成员函数) | |
销毁一个 any 对象(公共成员函数) | |
修改器 | |
更改包含对象,直接构造新对象 (公共成员函数) | |
销毁包含对象 (公共成员函数) | |
交换两个 any 对象(公共成员函数) | |
观察者 | |
检查对象是否包含值 (公共成员函数) | |
返回包含值的 typeid (公共成员函数) |
[编辑] 非成员函数
(C++17) |
专门化 std::swap 算法 (函数) |
(C++17) |
类型安全的访问包含对象 (函数模板) |
(C++17) |
创建一个 any 对象(函数模板) |
[编辑] 辅助类
(C++17) |
由 any_cast 的返回值形式在类型不匹配时抛出的异常(类) |
[编辑] 注释
功能测试 宏 | 值 | Std | 功能 |
---|---|---|---|
__cpp_lib_any |
201606L | (C++17) | std::any
|
[编辑] 示例
运行此代码
#include <any> #include <iostream> int main() { std::cout << std::boolalpha; // any type std::any a = 1; std::cout << a.type().name() << ": " << std::any_cast<int>(a) << '\n'; a = 3.14; std::cout << a.type().name() << ": " << std::any_cast<double>(a) << '\n'; a = true; std::cout << a.type().name() << ": " << std::any_cast<bool>(a) << '\n'; // bad cast try { a = 1; std::cout << std::any_cast<float>(a) << '\n'; } catch (const std::bad_any_cast& e) { std::cout << e.what() << '\n'; } // has value a = 2; if (a.has_value()) std::cout << a.type().name() << ": " << std::any_cast<int>(a) << '\n'; // reset a.reset(); if (!a.has_value()) std::cout << "no value\n"; // pointer to contained data a = 3; int* i = std::any_cast<int>(&a); std::cout << *i << '\n'; }
可能的输出
int: 1 double: 3.14 bool: true bad any_cast int: 2 no value 3
[编辑] 参见
(C++11) |
任何可复制构造的可调用对象的复制包装器 (类模板) |
(C++23) |
任何支持给定调用签名中限定符的可调用对象的仅移动包装器 (类模板) |
(C++17) |
一个类型安全的判别联合 (类模板) |
(C++17) |
一个可能包含也可能不包含对象的包装器 (类模板) |