std::simd::rotl(C++26)

namespace std::simd {
  template<simd-vec-type V0, simd-vec-type V1>
  constexpr V0 rotl(const V0& v0, const V1& v1) noexcept; // (1) C++26

  template<simd-vec-type V>
  constexpr V rotl(const V& v, int s) noexcept;           // (2) C++26
}

概要

符号なし整数要素をもつbasic_vecの各要素に対して、std::rotlを要素ごとに適用し、各要素のビットを左に循環シフトする。

• (1) : 各要素をシフト量v1[i]だけ左に循環シフトする
• (2) : 各要素を同一のシフト量sだけ左に循環シフトする

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

• (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) : i番目の要素がstd::rotl(v0[i], static_cast<int>(v1[i]))で初期化されたbasic_vecオブジェクトを返す
• (2) : i番目の要素がstd::rotl(v[i], s)で初期化されたbasic_vecオブジェクトを返す

例外

投げない

例

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

namespace simd = std::simd;

int main()
{
  // {0x0001, 0x0010, 0x0100, 0x1000}
  simd::vec<std::uint16_t, 4> v {[](int i) {
    return static_cast<std::uint16_t>(1u << (i * 4));
  }};

  // 各要素を4ビットだけ左に循環シフトする
  simd::vec<std::uint16_t, 4> r = simd::rotl(v, 4);

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

出力

0000000000000001 -> 0000000000010000
0000000000010000 -> 0000000100000000
0000000100000000 -> 0001000000000000
0001000000000000 -> 0000000000000001

バージョン

言語

• C++26

処理系

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

関連項目

• std::rotl
• std::simd::rotr

参照

• P1928R15 std::simd — merge data-parallel types from the Parallelism TS 2
  • C++26でstd::simdライブラリが追加された
• P2933R4 Extend <bit> header function with overloads for std::simd
  • C++26で<bit>ヘッダの関数にstd::simd向けのオーバーロードが追加された