std::conj(std::complex)

Определено в заголовке `<complex>`
	(1)
template< class T > std::complex<T> conj( const std::complex<T>& z );		(до C++20)
template< class T > constexpr std::complex<T> conj( const std::complex<T>& z );		(с C++20)
Дополнительные перегрузки (с C++11)
Определено в заголовке `<complex>`
	(A)
std::complex<float> conj( float f ); std::complex<double> conj( double f ); std::complex<long double> conj( long double f );		(до 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)
	(B)
template< class Integer > constexpr std::complex<double> conj( Integer i );		(до C++20)
template< class Integer > constexpr std::complex<double> conj( Integer i );		(с 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/w/cpp/numeric/complex/conj