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 文档