std::conj(std::complex)

Определено в заголовочном файле `<complex>`
template< class T > std::complex<T> conj( const std::complex<T>& z );	(1)	(до C++20)
template< class T > constexpr std::complex<T> conj( const std::complex<T>& z );	(1)		(начиная с C++20)
Дополнительные перегрузки (начиная с C++11)
Определено в заголовочном файле `<complex>`
std::complex<float> conj( float f ); std::complex<double> conj( double f ); std::complex<long double> conj( long double f );	(A)	(до C++20)
constexpr std::complex<float> conj( float f ); constexpr std::complex<double> conj( double f ); constexpr std::complex<long double> conj( long double f );			(начиная с C++20) (до C++23)
template< class FloatingPoint > constexpr std::complex<FloatingPoint> conj( FloatingPoint f );			(начиная с C++23)
template< class Integer > constexpr std::complex<double> conj( Integer i );	(B)	(до C++20)
template< class Integer > constexpr std::complex<double> conj( Integer i );	(B)		(начиная с C++20)

1) Вычисляет комплексно-сопряжённое число z, меняя знак мнимой части на противоположный.

A,B) Предоставляются дополнительные перегрузки для всех целочисленных типов и типов с плавающей точкой, которые рассматриваются как комплексные числа с нулевой мнимой частью.

(начиная с C++11)

Параметры

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

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

1) Комплексно-сопряжённое число для z.

A) std::complex(f).

B) std::complex<double>(i).

Примечания

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

Если num имеет стандартный(до C++23) тип с плавающей точкой T, то std::conj(num) действует так же, как std::conj(std::complex<T>(num)).
Иначе, если num имеет целочисленный тип, то std::conj(num) действует так же, как std::conj(std::complex<double>(num)).

Пример

#include <complex>
#include <iostream>

int main()
{
    std::complex<double> z(1.0, 2.0);
    std::cout << "The conjugate of " << z << " is " << std::conj(z) << '\n'
              << "Their product is " << z * std::conj(z) << '\n';
}

Вывод:

The conjugate of (1,2) is (1,-2)
Their product is (5,0)

См. также

abs(std::complex)	возвращает модуль комплексного числа (шаблон функции)
norm	возвращает квадрат модуля (шаблон функции)
polar	создаёт комплексное число по модулю и фазовому углу (шаблон функции)
Документация по C для `conj`

© cppreference.com
Licensed under the Creative Commons Attribution-ShareAlike Unported License v3.0.
https://en.cppreference.com/cpp/numeric/complex/conj