std::imag(std::complex)

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

1) Возвращает мнимую часть комплексного числа z, т.е. z.imag().

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

(с C++11)

Параметры

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

Значение результата

1) Мнимая часть z.

A) decltype(f){} (ноль).

B) 0.0.

Примечания

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

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

См. также

imag	доступ к мнимой части комплексного числа (публичный член-функция)
real	возвращает действительную часть (шаблон функции)
C документация для `cimag`

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