std::simd::bit_repeat(C++29)

namespace std::simd {
  template<simd-integral V0, simd-integral V1>
  constexpr V0 bit_repeat(const V0& v0, const V1& v1); // (1) C++29

  template<simd-integral V>
  constexpr V bit_repeat(const V& v, int l);           // (2) C++29
}

概要

符号なし整数要素をもつbasic_vecの各要素に対して、<bit>ヘッダのstd::bit_repeatを要素ごとに適用し、各要素の最下位からlビットのパターンを、要素の幅を埋めるように繰り返す。

• (1) : 各要素について繰り返すビット数をv1[i]で指定する
• (2) : すべての要素について繰り返すビット数を同一のlで指定する

テンプレートパラメータ制約

• (1) :
  • V0::value_typeが符号なし整数型であること
  • V1::value_typeが整数型であること
  • V0::size() == V1::size()がtrueであること
  • sizeof(typename V0::value_type) == sizeof(typename V1::value_type)がtrueであること
• (2) :
  • V::value_typeが符号なし整数型であること

事前条件

• (1) : すべての要素についてv1[i] > 0がtrueであること
• (2) : l > 0がtrueであること

戻り値

• (1) : i番目の要素がstd::bit_repeat(v0[i], static_cast<int>(v1[i]))で初期化されたbasic_vecオブジェクトを返す
• (2) : i番目の要素がstd::bit_repeat(v[i], l)で初期化されたbasic_vecオブジェクトを返す

例外

投げない

備考

• 事前条件に違反する関数呼び出し式は、定数式として評価されない。

例

#include <simd>
#include <print>
#include <cstdint>

namespace simd = std::simd;

int main()
{
  // {0x0001, 0x0003, 0x0005, 0x0007}
  simd::vec<std::uint16_t, 4> v {[](int i) {
    return static_cast<std::uint16_t>(2 * i + 1);
  }};

  // 各要素の最下位4ビットのパターンを繰り返す
  simd::vec<std::uint16_t, 4> r = simd::bit_repeat(v, 4);

  for (int i = 0; i < v.size(); ++i) {
    std::println("{:016b} -> {:016b}", v[i], r[i]);
  }
}

出力

0000000000000001 -> 0001000100010001
0000000000000011 -> 0011001100110011
0000000000000101 -> 0101010101010101
0000000000000111 -> 0111011101110111

バージョン

言語

• C++29

処理系

• Clang: 22 ❌
• GCC: 16.1 ❌
• Visual C++: 2026 Update 2 ❌

関連項目

• std::simd::basic_vec

参照

• P3104R3 Bit permutations
  • C++29で<bit>ヘッダにスカラー版のbit_repeatが追加された
• P3772R1 std::simd overloads for bit permutations
  • C++29でstd::simd版のオーバーロードが追加された