std::imag(std::complex)

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