std::arg(std::complex)

C++ 参考手册

C++11
C++14
C++17
C++20
C++ 编译器支持情况表
独立与宿主实现
C++ 语言
C++ 关键词
预处理器
C++ 标准库头文件
具名要求
功能特性测试 (C++20)
工具库
类型支持（基本类型、RTTI、类型特性）
概念库 (C++20)
错误处理
动态内存管理
日期和时间工具
字符串库
容器库
迭代器库
范围库 (C++20)
算法库
数值库
常用数学函数
数学特殊函数
伪随机数生成
浮点环境
std::complex
std::complex<T>::complex
std::complex<T>::operator=
std::complex<T>::real
std::literals::complex_literals::operator""i, operator""if, operator""il
std::complex<T>::imag
std::complex<T>::operator+=,-=,*=,/=
std::complex<T>::operator+(unary), operator-(unary)
operator+,-,*,/ (std::complex)
operator==,!=(std::complex)
operator<<,>>(std::complex)
std::real(std::complex)
std::imag(std::complex)
std::abs(std::complex)
std::arg(std::complex)
std::norm(std::complex)
std::conj(std::complex)
std::proj(std::complex)
std::polar(std::complex)
std::exp(std::complex)
std::log(std::complex)
std::log10(std::complex)
std::pow(std::complex)
std::sqrt(std::complex)
std::sin(std::complex)
std::cos(std::complex)
std::tan(std::complex)
std::asin(std::complex)
std::acos(std::complex)
std::atan(std::complex)
std::sinh(std::complex)
std::cosh(std::complex)
std::tanh(std::complex)
std::asinh(std::complex)
std::acosh(std::complex)
std::atanh(std::complex)
std::midpoint
std::lerp
std::has_single_bit
std::bit_ceil
std::bit_floor
std::bit_width
std::rotl
std::valarray
编译时有理数算术
std::gcd
std::lcm
数学常数
std::bit_cast
std::rotr
std::countl_zero
std::countl_one
std::countr_zero
std::countr_one
std::popcount
注释
输入/输出库
文件系统库
本地化库
正则表达式库
原子操作库
线程支持库
实验性 C++ 特性
有用的资源
索引
std 符号索引
协程支持 (C++20)
C++ 关键词

位置：首页 > C++ 参考手册 >数值库 >std::complex > std::arg(std::complex)

定义于头文件 `<complex>`
template< class T > T arg( const complex<T>& z );	(1)
long double arg( long double z );	(2)	(C++11 起)
template< class DoubleOrInteger > double arg( DoubleOrInteger z );	(3)	(C++11 起)
float arg( float z );	(4)	(C++11 起)

计算复数 z 的辐角（以弧度表示）

(C++11 起)为 float 、 double 、 long double 及所有整数类型提供重载，它们被当做有零虚部的复数

参数

z	-	复数值

返回值

若无错误发生，则返回 z 在区间 $(-π; π)$ 内的辐角。

错误和特殊情况按照函数宛如以 std::atan2(std::imag(z), std::real(z)) 实现来处理。

示例

运行此代码

#include <iostream>
#include <complex>
 
int main() 
{
    std::complex<double> z1(1, 0); 
    std::cout << "phase angle of " << z1 << " is " << std::arg(z1) << '\n';
 
    std::complex<double> z2(0, 1); 
    std::cout << "phase angle of " << z2 << " is " << std::arg(z2) << '\n';
 
    std::complex<double> z3(-1, 0); 
    std::cout << "phase angle of " << z3 << " is " << std::arg(z3) << '\n';
 
    std::complex<double> z4(-1, -0.0); 
    std::cout << "phase angle of " << z4 << " (the other side of the cut) is "
              << std::arg(z4) << '\n';
}

输出：

phase angle of (1,0) is 0
phase angle of (0,1) is 1.5708
phase angle of (-1,0) is 3.14159
phase angle of (-1,-0) (the other side of the cut) is -3.14159

参阅

abs(std::complex)	返回复数的模 (函数模板)
polar	从模和辐角构造复数 (函数模板)
atan2atan2fatan2l (C++11)(C++11)	反正切，用符号确定象限 (函数)
atan2(std::valarray)	应用函数 std::atan2 到一个 valarray 和一个值 (函数模板)