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

namespace std::simd {
  template<simd-integral V>
  constexpr V
    bit_compress(const V& v, const V& m) noexcept;               // (1) C++29

  template<simd-integral V>
  constexpr V
    bit_compress(const V& v, typename V::value_type m) noexcept; // (2) C++29
}

概要

符号なし整数要素をもつbasic_vecの各要素に対して、<bit>ヘッダのstd::bit_compressを要素ごとに適用する。各要素について、マスクのビットが立っている位置の値vのビットを集め、下位ビットへ詰めて配置する。

• (1) : 各要素についてマスクをm[i]で指定する
• (2) : すべての要素について同一のマスクmを指定する

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

• V::value_typeが符号なし整数型であること

戻り値

• (1) : i番目の要素がstd::bit_compress(v[i], m[i])で初期化されたbasic_vecオブジェクトを返す
• (2) : i番目の要素がstd::bit_compress(v[i], m)で初期化されたbasic_vecオブジェクトを返す

例外

投げない

例

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

namespace simd = std::simd;

int main()
{
  // {0x0010, 0x0020, 0x0030, 0x0040}
  simd::vec<std::uint16_t, 4> v {[](int i) {
    return static_cast<std::uint16_t>((i + 1) << 4);
  }};

  // マスク0x00f0で立っているビット（第4〜7ビット）を下位へ詰める
  simd::vec<std::uint16_t, 4> r = simd::bit_compress(v, std::uint16_t{0x00f0});

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

出力

0000000000010000 -> 0000000000000001
0000000000100000 -> 0000000000000010
0000000000110000 -> 0000000000000011
0000000001000000 -> 0000000000000100

バージョン

言語

• C++29

処理系

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

関連項目

• std::simd::bit_expand

参照

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