std::any

 

C++

コンパイラサポート

フリースタンディングとホスト

言語

標準ライブラリ

標準ライブラリヘッダー

名前付き要件

機能テストマクロ (C++20)

言語サポートライブラリ

コンセプトライブラリ (C++20)

診断ライブラリ

メモリ管理ライブラリ

メタプログラミングライブラリ (C++11)

汎用ユーティリティライブラリ

コンテナライブラリ

イテレータライブラリ

Rangesライブラリ (C++20)

アルゴリズムライブラリ

文字列ライブラリ

テキスト処理ライブラリ

数値ライブラリ

日付と時刻ライブラリ

入出力ライブラリ

ファイルシステムライブラリ (C++17)

並行サポートライブラリ (C++11)

実行制御ライブラリ (C++26)

Technical specifications (技術仕様)

シンボルインデックス

外部ライブラリ

 

ユーティリティライブラリ

言語サポート 型のサポート (基本型、RTTI) ライブラリ機能検査マクロ (C++20) プログラムユーティリティ 可変引数関数 initializer_list (C++11) is_constant_evaluated (C++20) is_within_lifetime (C++26) source_location (C++20) コルーチンサポート (C++20) 契約サポート (C++26) 三方比較 three_way_comparablethree_way_comparable_with (C++20)(C++20) strong_ordering (C++20) weak_ordering (C++20) partial_ordering (C++20) common_comparison_category (C++20) compare_three_way_result (C++20) compare_three_way (C++20) strong_order (C++20) weak_order (C++20) partial_order (C++20) compare_strong_order_fallback (C++20) compare_weak_order_fallback (C++20) compare_partial_order_fallback (C++20)   is_eqis_ltis_lteq (C++20)(C++20)(C++20)   is_neqis_gtis_gteq (C++20)(C++20)(C++20)

汎用ユーティリティ 関数オブジェクト ビット操作 (C++20) bitset hash (C++11) 関係演算子 (C++20で非推奨) rel_ops::operator!=rel_ops::operator>    rel_ops::operator<=rel_ops::operator>= 整数比較関数 cmp_equalcmp_lesscmp_less_than (C++20)(C++20)(C++20)   cmp_not_equalcmp_greatercmp_greater_than (C++20)(C++20)(C++20) in_range (C++20) スワップと型操作 swap ranges::swap (C++20) exchange (C++14) declval (C++11) to_underlying (C++23) forward (C++11) forward_like (C++23) move (C++11) move_if_noexcept (C++11) as_const (C++17) 共通語彙型 pair tuple (C++11) optional (C++17) any (C++17) variant (C++17) tuple_size (C++11) tuple_element (C++11) apply (C++17) make_from_tuple (C++17) expected (C++23)

 

std::any

メンバ関数

any::any

any::~any

any::operator=

変更

any::emplace

any::reset

any::swap

監視

any::has_value

any::type

非メンバ関数

swap(std::any)

any_cast

make_any

ヘルパークラス

bad_any_cast

 

ヘッダー <any> で定義
class any;		(C++17以降)

クラス any は、任意のコピー構築可能な型の単一の値を、型安全に保持するためのコンテナを記述します。

1) any クラスのオブジェクトは、コンストラクタの要件を満たす任意の型のインスタンスを格納するか、空になります。これは any クラスのオブジェクトの状態と呼ばれます。格納されたインスタンスは、内包オブジェクトと呼ばれます。2つの状態は、両方が空であるか、両方が空でなく内包オブジェクトが等価である場合に等価となります。

2) 非メンバ関数 any_cast は、内包オブジェクトへの型安全なアクセスを提供します。

実装は、小さなオブジェクトに対する動的メモリ確保を避けることが推奨されますが、そのような最適化は std::is_nothrow_move_constructible が true を返す型にのみ適用できます。

メンバ関数

(コンストラクタ)	any オブジェクトを構築する (公開メンバ関数)
operator=	any オブジェクトを代入する (公開メンバ関数)
(デストラクタ)	any オブジェクトを破棄する (公開メンバ関数)
変更
emplace	内包オブジェクトを変更し、新しいオブジェクトを直接構築する (公開メンバ関数)
reset	内包オブジェクトを破棄する (公開メンバ関数)
swap	2つの any オブジェクトを交換する (公開メンバ関数)
監視
has_value	オブジェクトが値を保持しているか確認する (公開メンバ関数)
type	内包する値の typeid を返す (公開メンバ関数)

非メンバ関数

std::swap(std::any) (C++17)	std::swap アルゴリズムを特殊化する (関数)
any_cast (C++17)	内包オブジェクトへの型安全なアクセス (関数テンプレート)
make_any (C++17)	any オブジェクトを生成する (関数テンプレート)

ヘルパークラス

bad_any_cast (C++17)

any_cast の値を返す形式で、型の不一致があった場合に送出される例外 (クラス)

ノート

機能テストマクロ	値	規格	機能
__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)	コピー構築可能な任意の呼び出し可能オブジェクトをラップするコピー可能なラッパー (クラステンプレート)
move_only_function (C++23)	与えられた呼び出しシグネチャで修飾子をサポートする任意の呼び出し可能オブジェクトのムーブ専用ラッパー (クラステンプレート)
variant (C++17)	型安全な判別共用体 (クラステンプレート)
optional (C++17)	オブジェクトを保持しているかもしれないし、していないかもしれないラッパー (クラステンプレート)