std::any

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

类 any 描述一种可用于任何可复制构造类型的单个值的类型安全容器。

1) 类 any 的对象存储���足构造函数要求的任何类型的一个实例或为空，这被称为 any 类对象的状态。存储的实例被称作所含对象。若两个状态均为空，或均为非空且其所含对象等价，则两个状态等价。
2) 非成员 any_cast 函数提供对所含对象的类型安全访问。

鼓励实现避免小对象的动态分配，但这种优化仅可以应用于 std::is_nothrow_move_constructible 对其返回 true 的类型。 通常，实现会对 std::is_nothrow_move_constructible 为 true 的类型进行小对象优化（避免动态分配）。

目录

[编辑] 成员函数

 构造 any 对象
(公开成员函数) [编辑]
赋值 any 对象
(公开成员函数) [编辑]
销毁 any 对象
(公开成员函数) [编辑]
修改器
更改所含对象，直接构造新对象
(公开成员函数) [编辑]
销毁所含对象
(公开成员函数) [编辑]
交换两个 any 对象
(公开成员函数) [编辑]
观察器
检查对象是否含有值
(公开成员函数) [编辑]
返回所含值的 typeid
(公开成员函数) [编辑]

[编辑] 非成员函数

(C++17)
 特化 std::swap 算法
(函数) [编辑]
(C++17)
 对所含对象的类型安全访问
(函数模板) [编辑]
(C++17)
 创建 any 对象
(函数模板) [编辑]

[编辑] 辅助类

(C++17)
 当类型不匹配时由按值返回形式的 any_cast 所抛出的异常
(类) [编辑]

[编辑] 注解

功能特性测试宏 值 标准 功能特性
__cpp_lib_any 201606L (C++17) std::any

[编辑] 示例

运行此代码
#include <any>
#include <iostream>
 
int main()
{
    std::cout << std::boolalpha;
 
    // any 类型
    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';
 
    // 有误的转型
    try
    {
        a = 1;
        std::cout << std::any_cast<float>(a) << '\n';
    }
    catch (const std::bad_any_cast& e)
    {
        std::cout << e.what() << '\n';
    }
 
    // 拥有值
    a = 2;
    if (a.has_value())
        std::cout << a.type().name() << ": " << std::any_cast<int>(a) << '\n';
 
    // 重置
    a.reset();
    if (!a.has_value())
        std::cout << "没有值\n";
 
    // 指向所含数据的指针
    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
没有值
3

[编辑] 参阅

(C++11)
 任意可复制构造的可调用对象的可复制包装
(类模板) [编辑]
(C++23)
 任意可调用对象的仅移动包装，支持给定调用签名中的限定符
(类模板) [编辑]
(C++17)
 类型安全的可辨识联合体
(类模板) [编辑]
(C++17)
 可能或可能不保有一个对象的包装器
(类模板) [编辑]
(C++11)
 拥有独有对象所有权语义的智能指针
(类模板) [编辑]
(C++26)
 包含动态分配对象的具有类似值语义的包装器
(类模板) [编辑]
(C++26)
 包含动态分配对象的带有类似值语义的多态包装器
(类模板) [编辑]
来自“https://zh.cppreference.com/mwiki/index.php?title=cpp/utility/any&oldid=100916”