| primary template std::complex<T> |
||
| (1) | ||
T imag() const; |
(until C++14) | |
| constexpr T imag() const; |
(since C++14) | |
| (2) | ||
void imag( T value ); |
(until C++20) | |
| constexpr void imag( T value ); |
(since C++20) | |
| specialization std::complex<float> |
||
| (1) | ||
float imag() const; |
(until C++11) | |
| constexpr float imag() const; |
(since C++11) | |
| (2) | ||
void imag( float value ); |
(until C++20) | |
| constexpr void imag( float value ); |
(since C++20) | |
| specialization std::complex<double> |
||
| (1) | ||
double imag() const; |
(until C++11) | |
| constexpr double imag() const; |
(since C++11) | |
| (2) | ||
void imag( double value ); |
(until C++20) | |
| constexpr void imag( double value ); |
(since C++20) | |
| specialization std::complex<long double> |
||
| (1) | ||
long double imag() const; |
(until C++11) | |
| constexpr long double imag() const; |
(since C++11) | |
| (2) | ||
void imag( long double value ); |
(until C++20) | |
| constexpr void imag( long double value ); |
(since C++20) | |
Accesses the imaginary part of the complex number.
value.Parameters
| value | - | the value to set the imaginary part to |
Return value
*this.Notes
In C++11, overload (1) in std::complex specializations used to be specified without const qualifier. However, in C++11, a constexpr specifier used in a non-static member function implies const, and thus the behavior is as if const is specified.
Defect reports
The following behavior-changing defect reports were applied retroactively to previously published C++ standards.
| DR | Applied to | Behavior as published | Correct behavior |
|---|---|---|---|
| LWG 387 | C++98 | the imaginary part could not be set directly | can be set directly via a new imag overload
|
See also
| returns the imaginary part (function template) | |
| accesses the real part of the complex number (public member function) |
Content from this page on cppreference.com, licensed under CC-BY-SA 3.0 and GFDL. Modified: restyled, site navigation removed, code windows added. Offline snapshot of 9 February 2025.