標準ライブラリヘッダー <complex>

 

C++

コンパイラサポート

フリースタンディングとホスト

言語

標準ライブラリ

標準ライブラリヘッダー

名前付き要件

機能テストマクロ (C++20)

言語サポートライブラリ

コンセプトライブラリ (C++20)

診断ライブラリ

メモリ管理ライブラリ

メタプログラミングライブラリ (C++11)

汎用ユーティリティライブラリ

コンテナライブラリ

イテレータライブラリ

Rangesライブラリ (C++20)

アルゴリズムライブラリ

文字列ライブラリ

テキスト処理ライブラリ

数値ライブラリ

日付と時刻ライブラリ

入出力ライブラリ

ファイルシステムライブラリ (C++17)

並行サポートライブラリ (C++11)

実行制御ライブラリ (C++26)

Technical specifications (技術仕様)

シンボルインデックス

外部ライブラリ

 

標準ライブラリヘッダー

言語サポート <cfloat> <climits> <compare> (C++20) <contracts> (C++26) <coroutine> (C++20) <csetjmp> <csignal> <cstdarg> <cstddef> <cstdint> (C++11) <cstdlib> <exception> <initializer_list> (C++11)    <limits> <new> <source_location> (C++20) <stdfloat> (C++23) <typeinfo> <version> (C++20) コンセプト <concepts> (C++20) 診断 <cassert> <cerrno> <debugging> (C++26) <stacktrace> (C++23) <stdexcept> <system_error> (C++11) メモリ管理 <memory> <memory_resource> (C++17) <scoped_allocator> (C++11) メタプログラミング <type_traits> (C++11) <ratio> (C++11)

汎用ユーティリティ <any> (C++17) <bitset> <bit> (C++20) <charconv> (C++17) <expected> (C++23) <format> (C++20) <functional> <optional> (C++17) <tuple> (C++11) <typeindex> (C++11) <utility> <variant> (C++17) コンテナ <array> (C++11) <deque> <flat_map> (C++23) <flat_set> (C++23) <forward_list> (C++11) <hive> (C++26) <inplace_vector> (C++26)    <list> <map> <mdspan> (C++23) <queue> <set> <span> (C++20) <stack> <unordered_map> (C++11) <unordered_set> (C++11) <vector> イテレータ <iterator> Ranges <generator> (C++23) <ranges> (C++20)

アルゴリズム <algorithm> <numeric> 文字列 <cctype> <cstring> <cuchar> (C++11) <cwchar> <cwctype> <string_view> (C++17) <string> テキスト処理 <clocale> <codecvt> (C++11/17/26*) <locale> <regex> (C++11) <text_encoding> (C++26)    数値 <cfenv> (C++11) <cmath> <complex> <linalg> (C++26) <numbers> (C++20) <random> (C++11) <simd> (C++26) <valarray> 時間 <chrono> (C++11) <ctime> C互換 <ccomplex> (C++11/17/20*) <ciso646> (C++20 まで) <cstdalign> (C++11/17/20*) <cstdbool> (C++11/17/20*) <ctgmath> (C++11/17/20*)

入出力 <cinttypes> (C++11) <cstdio> <filesystem> (C++17) <fstream> <iomanip> <iosfwd> <iostream> <ios> <istream> <ostream> <print> (C++23) <spanstream> (C++23) <sstream> <streambuf> <strstream> (C++98/26*) <syncstream> (C++20) 並行性サポート <atomic> (C++11) <barrier> (C++20) <condition_variable> (C++11) <future> (C++11) <hazard_pointer> (C++26) <latch> (C++20) <mutex> (C++11) <rcu> (C++26) <semaphore> (C++20) <shared_mutex> (C++14) <stdatomic.h> (C++23) <stop_token> (C++20) <thread> (C++11) 実行サポート <execution> (C++17)

 

このヘッダーは数値ライブラリの一部です。

クラス

complex

複素数型 (クラステンプレート)

関数

操作
operator+operator-	複素数に単項演算子を適用する (関数テンプレート)
operator+operator-operator*operator/	2つの複素数値、または複素数とスカラ値の複素数演算を実行する (関数テンプレート)
operator==operator!= (C++20で削除)	2つの複素数、または複素数とスカラ値を比較する (関数テンプレート)
operator<<operator>>	複素数をシリアライズ・デシリアライズする (関数テンプレート)
real	実部を返す (関数テンプレート)
imag	虚部を返す (関数テンプレート)
abs(std::complex)	複素数の大きさを返す (関数テンプレート)
arg	偏角を返す (関数テンプレート)
norm	大きさの2乗を返す (関数テンプレート)
conj	複素共役を返す (関数テンプレート)
proj (C++11)	リーマン球面への射影を返す (関数テンプレート)
polar	大きさと偏角から複素数を構築する (関数テンプレート)
指数関数
exp(std::complex)	複素数の底eの指数関数 (関数テンプレート)
log(std::complex)	複素数の自然対数、分枝切断は負の実軸に沿う (関数テンプレート)
log10(std::complex)	複素数の常用対数、分枝切断は負の実軸に沿う (関数テンプレート)
べき乗関数
pow(std::complex)	複素数のべき乗、引数の一方または両方が複素数 (関数テンプレート)
sqrt(std::complex)	複素数の平方根、右半平面の範囲 (関数テンプレート)
三角関数
sin(std::complex)	複素数の正弦 (サイン) を計算する (\({\small\sin{z}}\)sin(z)) (関数テンプレート)
cos(std::complex)	複素数の余弦 (コサイン) を計算する (\({\small\cos{z}}\)cos(z)) (関数テンプレート)
tan(std::complex)	複素数の正接 (タンジェント) を計算する (\({\small\tan{z}}\)tan(z)) (関数テンプレート)
asin(std::complex) (C++11)	複素数の逆正弦 (アークサイン) を計算する (\({\small\arcsin{z}}\)arcsin(z)) (関数テンプレート)
acos(std::complex) (C++11)	複素数の逆余弦 (アークコサイン) を計算する (\({\small\arccos{z}}\)arccos(z)) (関数テンプレート)
atan(std::complex) (C++11)	複素数の逆正接 (アークタンジェント) を計算する (\({\small\arctan{z}}\)arctan(z)) (関数テンプレート)
双曲線関数
sinh(std::complex)	複素数の双曲線正弦 (ハイパボリックサイン) を計算する (\({\small\sinh{z}}\)sinh(z)) (関数テンプレート)
cosh(std::complex)	複素数の双曲線余弦 (ハイパボリックコサイン) を計算する (\({\small\cosh{z}}\)cosh(z)) (関数テンプレート)
tanh(std::complex)	複素数の双曲線正接 (ハイパボリックタンジェント) を計算する (\({\small\tanh{z}}\)tanh(z)) (関数テンプレート)
asinh(std::complex) (C++11)	複素数の逆双曲線正弦 (エリアハイパボリックサイン) を計算する (\({\small\operatorname{arsinh}{z}}\)arsinh(z)) (関数テンプレート)
acosh(std::complex) (C++11)	複素数の逆双曲線余弦 (エリアハイパボリックコサイン) を計算する (\({\small\operatorname{arcosh}{z}}\)arcosh(z)) (関数テンプレート)
atanh(std::complex) (C++11)	複素数の逆双曲線正接 (エリアハイパボリックタンジェント) を計算する (\({\small\operatorname{artanh}{z}}\)artanh(z)) (関数テンプレート)
リテラル
operator""ifoperator""ioperator""il (C++14)	純虚数を表す std::complex リテラル (関数)

概要

namespace std {
    template<class T> class complex;
 
    template<> class complex<float>;
    template<> class complex<double>;
    template<> class complex<long double>;
 
    // operators:
    template<class T> constexpr complex<T> operator+(
        const complex<T>&, const complex<T>&);
    template<class T> constexpr complex<T> operator+(const complex<T>&, const T&);
    template<class T> constexpr complex<T> operator+(const T&, const complex<T>&);
 
    template<class T> constexpr complex<T> operator-(
        const complex<T>&, const complex<T>&);
    template<class T> constexpr complex<T> operator-(const complex<T>&, const T&);
    template<class T> constexpr complex<T> operator-(const T&, const complex<T>&);
 
    template<class T> constexpr complex<T> operator*(
        const complex<T>&, const complex<T>&);
    template<class T> constexpr complex<T> operator*(const complex<T>&, const T&);
    template<class T> constexpr complex<T> operator*(const T&, const complex<T>&);
 
    template<class T> constexpr complex<T> operator/(
        const complex<T>&, const complex<T>&);
    template<class T> constexpr complex<T> operator/(const complex<T>&, const T&);
    template<class T> constexpr complex<T> operator/(const T&, const complex<T>&);
 
    template<class T> constexpr complex<T> operator+(const complex<T>&);
    template<class T> constexpr complex<T> operator-(const complex<T>&);
 
    template<class T> constexpr bool operator==(const complex<T>&, const complex<T>&);
    template<class T> constexpr bool operator==(const complex<T>&, const T&);
    template<class T> constexpr bool operator==(const T&, const complex<T>&);
 
    template<class T> constexpr bool operator!=(const complex<T>&, const complex<T>&);
    template<class T> constexpr bool operator!=(const complex<T>&, const T&);
    template<class T> constexpr bool operator!=(const T&, const complex<T>&);
 
    template<class T, class CharT, class Traits>
    basic_istream<CharT, Traits>&
    operator>>(basic_istream<CharT, Traits>&, complex<T>&);
 
    template<class T, class CharT, class Traits>
    basic_ostream<CharT, Traits>&
    operator<<(basic_ostream<CharT, Traits>&, const complex<T>&);
 
    // values:
    template<class T> constexpr T real(const complex<T>&);
    template<class T> constexpr T imag(const complex<T>&);
 
    template<class T> T abs(const complex<T>&);
    template<class T> T arg(const complex<T>&);
    template<class T> constexpr T norm(const complex<T>&);
 
    template<class T> constexpr complex<T> conj(const complex<T>&);
    template<class T> complex<T> proj(const complex<T>&);
    template<class T> complex<T> polar(const T&, const T& = 0);
 
    // transcendentals:
    template<class T> complex<T> acos(const complex<T>&);
    template<class T> complex<T> asin(const complex<T>&);
    template<class T> complex<T> atan(const complex<T>&);
 
    template<class T> complex<T> acosh(const complex<T>&);
    template<class T> complex<T> asinh(const complex<T>&);
    template<class T> complex<T> atanh(const complex<T>&);
 
    template<class T> complex<T> cos  (const complex<T>&);
    template<class T> complex<T> cosh (const complex<T>&);
    template<class T> complex<T> exp  (const complex<T>&);
    template<class T> complex<T> log  (const complex<T>&);
    template<class T> complex<T> log10(const complex<T>&);
 
    template<class T> complex<T> pow(const complex<T>&, const T&);
    template<class T> complex<T> pow(const complex<T>&, const complex<T>&);
    template<class T> complex<T> pow(const T&, const complex<T>&);
 
    template<class T> complex<T> sin (const complex<T>&);
    template<class T> complex<T> sinh(const complex<T>&);
    template<class T> complex<T> sqrt(const complex<T>&);
    template<class T> complex<T> tan (const complex<T>&);
    template<class T> complex<T> tanh(const complex<T>&);
 
    // tuple interface:
    template<class T> struct tuple_size;
    template<size_t I, class T> struct tuple_element;
    template<class T> struct tuple_size<complex<T>>;
    template<size_t I, class T> struct tuple_element<I, complex<T>>;
    template<size_t I, class T>
      constexpr T& get(complex<T>&) noexcept;
    template<size_t I, class T>
      constexpr T&& get(complex<T>&&) noexcept;
    template<size_t I, class T>
      constexpr const T& get(const complex<T>&) noexcept;
    template<size_t I, class T>
      constexpr const T&& get(const complex<T>&&) noexcept;
 
    // complex literals:
    inline namespace literals {
        inline namespace complex_literals {
            constexpr complex<long double> operator""il(long double);
            constexpr complex<long double> operator""il(unsigned long long);
            constexpr complex<double> operator""i(long double);
            constexpr complex<double> operator""i(unsigned long long);
            constexpr complex<float> operator""if(long double);
            constexpr complex<float> operator""if(unsigned long long);
        }
    }
}

クラス std::complex

template<class T>
class complex {
public:
    typedef T value_type;
    constexpr complex(const T& re = T(), const T& im = T());
    constexpr complex(const complex&) = default;
    template<class X> constexpr explicit(/* see constructor page */)
        complex(const complex<X>&);
 
    constexpr T real() const;
    constexpr void real(T);
    constexpr T imag() const;
    constexpr void imag(T);
 
    constexpr complex<T>& operator= (const T&);
    constexpr complex<T>& operator+=(const T&);
    constexpr complex<T>& operator-=(const T&);
    constexpr complex<T>& operator*=(const T&);
    constexpr complex<T>& operator/=(const T&);
 
    constexpr complex& operator=(const complex&);
    template<class X> constexpr complex<T>& operator= (const complex<X>&);
    template<class X> constexpr complex<T>& operator+=(const complex<X>&);
    template<class X> constexpr complex<T>& operator-=(const complex<X>&);
    template<class X> constexpr complex<T>& operator*=(const complex<X>&);
    template<class X> constexpr complex<T>& operator/=(const complex<X>&);
};

欠陥報告

以下の動作変更を伴う欠陥報告が、以前に公開されたC++標準に遡って適用されました。

DR	適用対象	公開された動作	正しい動作
LWG 79	C++98	第2パラメータのデフォルト引数 polarの概要に不足していた	追加された