最終更新日時(UTC): 2026年05月08日 02時02分17秒
Akira Takahashi が更新

履歴 編集

function
<meta>

# std::meta::annotations_of(C++26)

    namespace std::meta {
      consteval std::vector<info> annotations_of(info item);
    }

## 概要

宣言に付加されたすべてのアノテーションのリフレクションを取得する。

## 戻り値

`item`に付加されたすべてのアノテーションのリフレクションを格納した`std::vector`オブジェクトを返す。

## 例

    #include <meta>
    #include <print>

    struct Label { const char* text; };

    struct [[=Label{std::define_static_string("my struct")}, =42]] S {};

    int main() {
      static constexpr auto annots = std::define_static_array(std::meta::annotations_of(^^S));
      // annotsはconsteval-only型のため、実行時に使うにはサイズなどを
      // 定数式としてあらかじめ取り出しておく必要がある
      constexpr std::size_t count = annots.size();
      std::println("アノテーション数: {}", count);

      template for (constexpr auto a : annots) {
        // アノテーションの型名を出力
        std::println("  型: {}", std::meta::display_string_of(std::meta::type_of(a)));

        // 型ごとに値を取り出して出力
        // アノテーションは値のリフレクションではないため、
        // constant_of()で値を取り出してからスプライスする
        if constexpr (std::meta::type_of(a) == ^^const Label) {
          std::println("  値: {}", [:std::meta::constant_of(a):].text);
        } else if constexpr (std::meta::type_of(a) == ^^int) {
          std::println("  値: {}", [:std::meta::constant_of(a):]);
        }
      }
    }

### 出力

    アノテーション数: 2
      型: const Label
      値: my struct
      型: int
      値: 42

## バージョン

### 言語

- C++26

### 処理系

- Clang: ??
- GCC: 16 (`-freflection` オプション指定) ✅
- Visual C++: ??

## 関連項目

- `annotations_of_with_type`
- `is_annotation`

## 参照

- P3394R4 Annotations for Reflection