real.md

real

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

namespace std::simd {
  template<simd-complex V>
  constexpr rebind_t<simd-complex-value-type<V>, V> real(const V& v) noexcept; // C++26
}

• simd-complex-value-type[link /reference/simd/simd-complex-value-type.md]
• simd-complex[link /reference/simd/simd-complex.md]
• complex[link /reference/complex/complex.md]

概要

要素型がstd::complex<T>のbasic_vecについて、各要素の実部を取り出し、実数型Tを要素とするbasic_vecとして返す。

制約simd-complexは、Vが要素型std::complex<T>のbasic_vecであることを表す説明専用のコンセプトである。simd-complex-value-type<V>はVの要素型std::complex<T>におけるT（実数型）を表す。rebind_tは要素型を置き換えたbasic_vec型を得る別名であり、戻り値の型はVの要素数はそのままに要素型をTとしたbasic_vecとなる。

戻り値

各要素i（0以上V::size()未満）について、v[i]に<complex>のrealを適用した結果で初期化されたbasic_vecオブジェクトを返す。

例

#include <simd>
#include <complex>
#include <print>

namespace simd = std::simd;

int main()
{
  // 各要素が複素数のデータ並列型
  simd::vec<std::complex<float>, 2> v{
    [](int i) { return std::complex<float>(i + 1.0f, i + 0.5f); }
  };  // {(1, 0.5), (2, 1.5)}

  // 各要素の実部を取り出す
  simd::vec<float, 2> re = simd::real(v);

  for (std::size_t i = 0; i < re.size(); ++i)
    std::print("{} ", re[i]);
  std::println("");
}

• simd::real[color ff0000]

出力例

1 2 

バージョン

言語

• C++26

処理系

• Clang: 22 [mark noimpl]
• GCC: 16.1 [mark noimpl]
• Visual C++: 2026 Update 2 [mark noimpl]

関連項目

• std::simd::imag
• std::simd::abs
• std::simd::arg
• std::simd::norm
• std::simd::conj
• std::complex::real

参照

• P1928R15 std::simd — merge data-parallel types from the Parallelism TS 2
  • C++26でstd::simdライブラリが追加された
• P2663R7 Interleaved complex values support in std::simd
  • 要素型が複素数のbasic_vecに対する複素数関連の関数が追加された