Namespaces
Variants

    std:: arg (std::complex)

    From ru.cppreference.net
    C++
    Numerics library
    std::complex
    Определено в заголовке <complex>
    template < class T >
    T           arg ( const std:: complex < T > & z ) ;
    		(1)
    Определено в заголовке <complex>
    (A)
    float arg ( float f ) ;

    double arg ( double f ) ;

    long double arg ( long double f ) ;
    		(until C++23)
    template < class FloatingPoint >

    FloatingPoint

    arg ( FloatingPoint f ) ;
    		(since C++23)
    template < class Integer >
    double arg ( Integer i ) ;
    		(B)
    1) Вычисляет фазовый угол (в радианах) комплексного числа z .
    A,B) Для всех целочисленных и вещественных типов предоставлены дополнительные перегрузки, которые обрабатываются как комплексные числа с нулевой мнимой компонентой.
    		(since C++11)

    Содержание

    Параметры

    z - комплексное значение
    f - значение с плавающей запятой
    i - целочисленное значение

    Возвращаемое значение

    1) std:: atan2 ( std:: imag ( z ) , std:: real ( z ) ) . Если ошибок не возникает, это фазовый угол z в интервале [−π; π] .
    A) Ноль, если f положительный или +0, π если f отрицательный или -0, иначе NaN.
    Б) Ноль, если i неотрицательно, π если отрицательно.

    Примечания

    Дополнительные перегрузки не обязаны быть предоставлены именно в виде (A,B) . Они должны быть достаточными лишь для того, чтобы обеспечить для их аргумента num :

    • Если num имеет стандартный (до C++23) тип с плавающей запятой T , тогда std :: arg ( num ) имеет тот же эффект, что и std :: arg ( std:: complex < T > ( num ) ) .
    • В противном случае, если num имеет целочисленный тип, тогда std :: arg ( num ) имеет тот же эффект, что и std :: arg ( std:: complex < double > ( num ) ) .

    Пример

    Запустить этот код 
    #include <complex>
#include <iostream>
int main() 
{
    std::complex<double> z1(1, 0);
    std::complex<double> z2(0, 0);
    std::complex<double> z3(0, 1);
    std::complex<double> z4(-1, 0);
    std::complex<double> z5(-1, -0.0);
    double f = 1.;
    int i = -1;
    std::cout << "phase angle of " << z1 << " is " << std::arg(z1) << '\n'
              << "phase angle of " << z2 << " is " << std::arg(z2) << '\n'
              << "phase angle of " << z3 << " is " << std::arg(z3) << '\n'
              << "phase angle of " << z4 << " is " << std::arg(z4) << '\n'
              << "phase angle of " << z5 << " is " << std::arg(z5) << " "
                 "(the other side of the cut)\n"
              << "phase angle of " << f << " is " << std::arg(f) << '\n'
              << "phase angle of " << i << " is " << std::arg(i) << '\n';
}

    Вывод: 

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

    Смотрите также

    		возвращает модуль комплексного числа
    (шаблон функции)
    		создаёт комплексное число из модуля и фазового угла
    (шаблон функции)
    (C++11) (C++11)
    		арктангенс, использующий знаки для определения квадрантов
    (функция)
    		применяет функцию std::atan2 к valarray и значению
    (шаблон функции)
    Документация C для carg