std::literals::complex_literals::operator""i, operator""if, operator""il

 

C++

編譯器支援

自由（freestanding）與宿主（hosted）

語言

標準庫

標準庫標頭檔案

具名要求

特性測試宏 (C++20)

語言支援庫

概念庫 (C++20)

診斷庫

記憶體管理庫

超程式設計庫 (C++11)

通用工具庫

容器庫

迭代器庫

範圍庫 (C++20)

演算法庫

字串庫

文字處理庫

數值庫

日期和時間庫

輸入/輸出庫

檔案系統庫 (C++17)

併發支援庫 (C++11)

執行控制庫 (C++26)

技術規範

符號索引

外部庫

 

數值庫

常用數學函式
數學特殊函式 (C++17)
數學常數 (C++20)
基本線性代數演算法 (C++26)
資料並行型別 (SIMD) (C++26)
浮點環境 (C++11)
複數
數值陣列 (valarray)
偽隨機數生成
位操作 (C++20)
因子運算
gcd (C++17)	lcm (C++17)
插值
midpoint (C++20)	lerp (C++20)
飽和算術
add_sat (C++26) sub_sat (C++26) saturate_cast (C++26)	mul_sat (C++26) div_sat (C++26)
通用數值運算
iota (C++11) ranges::iota (C++23) accumulate inner_product adjacent_difference    partial_sum	reduce (C++17) transform_reduce (C++17) inclusive_scan (C++17) exclusive_scan (C++17) transform_inclusive_scan (C++17) transform_exclusive_scan (C++17)

 

std::complex

成員函式
complex::complex complex::operator= complex::real complex::imag	complex::operator+=complex::operator-=complex::operator*=complex::operator/=
非成員函式
operator+operator- operator+operator-operator*operator/ operator==operator!= (直到 C++20)   operator<<operator>> get(std::complex) (C++26)	real imag abs arg norm conj proj (C++11) polar operator""ioperator""ifoperator""il (C++14)(C++14)(C++14)
指數函式
log   log10   exp
冪函式
pow   sqrt
三角函式
sin   cos tan asin (C++11) acos (C++11) atan (C++11)
雙曲函式
sinh   cosh tanh asinh (C++11) acosh (C++11) atanh (C++11)
輔助型別
tuple_size<std::complex> (C++26)
tuple_element<std::complex> (C++26)

 

定義於標頭檔案 <complex>
constexpr complex<double> operator""i( long double arg ); constexpr complex<double> operator""i( unsigned long long arg );	(1)	(C++14 起)
constexpr complex<float> operator""if( long double arg ); constexpr complex<float> operator""if( unsigned long long arg );	(2)	(C++14 起)
constexpr complex<long double> operator""il( long double arg ); constexpr complex<long double> operator""il( unsigned long long arg );	(3)	(C++14 起)

形成表示虛數的 std::complex 字面量。

1) 形成實部為零、虛部為 arg 的 std::complex<double> 字面量。

2) 形成實部為零、虛部為 arg 的 std::complex<float> 字面量。

3) 形成實部為零、虛部為 arg 的 std::complex<long double> 字面量。

引數

arg

-

虛數的值

返回值

實部為零、虛部為 arg 的 std::complex 字面量。

注意

這些運算子在名稱空間 std::literals::complex_literals 中宣告，其中 literals 和 complex_literals 都是內聯名稱空間。可以透過以下任一方式訪問這些運算子：

• using namespace std::literals,
• using namespace std::complex_literals，或
• using namespace std::literals::complex_literals.

儘管 if 在 C++ 中是一個關鍵詞，但它是形式為 operator ""if 的字面量運算子的 ud-suffix，在字面量表達式（如 1if 或 1.0if）中也是如此，因為它們沒有用空格分隔，也不是獨立的標記。

特性測試宏	值	標準	特性
__cpp_lib_complex_udls	201309L	(C++14)	std::complex 的使用者定義字面量

可能的實現

operator""i
constexpr std::complex<double> operator""i(unsigned long long d) { return std::complex<double> {0.0, static_cast<double>(d)}; }   constexpr std::complex<double> operator""i(long double d) { return std::complex<double> {0.0, static_cast<double>(d)}; }
operator""if
constexpr std::complex<float> operator""if(unsigned long long d) { return std::complex<float> {0.0f, static_cast<float>(d)}; }   constexpr std::complex<float> operator""if(long double d) { return std::complex<float> {0.0f, static_cast<float>(d)}; }
operator""il
constexpr std::complex<long double> operator""il(unsigned long long d) { return std::complex<long double> {0.0L, static_cast<long double>(d)}; }   constexpr std::complex<long double> operator""il(long double d) { return std::complex<long double> {0.0L, d}; }

示例

執行此程式碼

#include <complex>
#include <iostream>
 
int main()
{
    using namespace std::complex_literals;
 
    std::complex<double> c = 1.0 + 1i;
    std::cout << "abs" << c << " = " << std::abs(c) << '\n';
 
    std::complex<float> z = 3.0f + 4.0if;
    std::cout << "abs" << z << " = " << std::abs(z) << '\n';
}

輸出

abs(1,1) = 1.41421
abs(3,4) = 5

參閱

(建構函式)	構造一個複數 (公共成員函式)
operator=	賦值內容 (公共成員函式)
有關 I 的 C 文件