define_static_array.md

define_static_array

• meta[meta header]
• std[meta namespace]
• function template[meta id-type]
• cpp26[meta cpp]

namespace std {
  template <ranges::input_range R>
  consteval std::span<const ranges::range_value_t<R>, see below> define_static_array(R&& r);
}

概要

コンパイル時に計算した配列を静的ストレージに配置し、その範囲を参照するspanを返す。

戻り値

rの要素をコピーした静的ストレージ上の配列を参照するstd::span<const T, Extent>を返す。

戻り値のstd::spanの第2テンプレート引数Extentは以下のように決まる：

• ranges::size(r)が定数式であれば、static_cast<std::size_t>(ranges::size(r))（静的長）
• そうでなければ、std::dynamic_extent（動的長）

例

#include <meta>
#include <print>
#include <array>

int main() {
  constexpr auto arr = std::define_static_array(std::array{1, 2, 3, 4, 5});
  for (auto v : arr) {
    std::println("{}", v);
  }
}

出力

1
2
3
4
5

バージョン

言語

• C++26

処理系

• Clang: ??
• GCC: 16 (-freflection オプション指定) [mark verified]
• Visual C++: ??

関連項目

• define_static_string
• define_static_object

参照

• P3491R3 define_static_{string,object,array}
• LWG Issue 4537. Improve define_static_array