命名空间
变体
操作

std::any

来自 cppreference.com
< cpp‎ | utility
 
 
实用程序库
语言支持
类型支持 (基本类型, RTTI)
库功能测试宏 (C++20)
动态内存管理
程序实用程序
协程支持 (C++20)
可变参数函数
调试支持
(C++26)
三元比较
(C++20)
(C++20)(C++20)(C++20)
(C++20)(C++20)(C++20)
通用实用程序
日期和时间
函数对象
格式化库 (C++20)
(C++11)
关系运算符 (C++20 中已弃用)
整数比较函数
(C++20)(C++20)(C++20)   
(C++20)
交换类型操作
(C++14)
(C++11)
(C++11)
(C++11)
(C++17)
通用词汇类型
(C++11)
(C++17)
any
(C++17)
(C++17)
(C++11)
(C++17)
(C++23)
基本字符串转换
(C++17)
(C++17)

 
 
定义在头文件 <any>
class any;
(自 C++17 起)

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

1)any 的对象存储任何满足构造函数要求的类型的实例,或者为空,这被称为类 any 对象的状态。存储的实例称为包含对象。如果两个状态都为空,或者如果两个状态都不为空,并且包含对象是等价的,则这两个状态是等价的。
2) 非成员 any_cast 函数提供对包含对象的类型安全访问。

鼓励实现避免对小型对象进行动态分配,但这种优化可能只适用于 std::is_nothrow_move_constructible 返回 true 的类型。

内容

[编辑] 成员函数

构造一个 any 对象
(公共成员函数) [编辑]
分配一个 any 对象
(公共成员函数) [编辑]
销毁一个 any 对象
(公共成员函数) [编辑]
修改器
更改包含对象,直接构造新对象
(公共成员函数) [编辑]
销毁包含对象
(公共成员函数) [编辑]
交换两个 any 对象
(公共成员函数) [编辑]
观察者
检查对象是否包含值
(公共成员函数) [编辑]
返回包含值的 typeid
(公共成员函数) [编辑]

[编辑] 非成员函数

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

[编辑] 辅助类

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++17)
一个类型安全的判别联合
(类模板) [编辑]
(C++17)
一个可能包含也可能不包含对象的包装器
(类模板) [编辑]