std::complex<T>::imag

 

C++

Compiler support

Freestanding and hosted

Language

Standard library headers

Named requirements

Feature test macros (C++20)

Language support library

Concepts library (C++20)

Metaprogramming library (C++11)

Diagnostics library

General utilities library

Strings library

Containers library

Iterators library

Ranges library (C++20)

Algorithms library

Numerics library

Localizations library

Input/output library

Filesystem library (C++17)

Regular expressions library (C++11)

Concurrency support library (C++11)

Technical specifications

Symbols index

External libraries

 

Numerics library

Common mathematical functions

Mathematical special functions (C++17)

Mathematical constants (C++20)

Floating-point environment (C++11)

Complex numbers

Numeric arrays

Pseudo-random number generation

Factor operations

gcd (C++17)

lcm (C++17)

Interpolations

midpoint (C++20)

lerp (C++20)

Generic numeric operations

iota (C++11)

ranges::iota (C++23)

accumulate

inner_product

adjacent_difference

partial_sum

reduce (C++17)

transform_reduce (C++17)

inclusive_scan (C++17)

exclusive_scan (C++17)

transform_inclusive_scan (C++17)

transform_exclusive_scan (C++17)

Bit operations

bit_cast (C++20)

byteswap (C++23)

has_single_bit (C++20)

bit_ceil (C++20)

bit_floor (C++20)

bit_width (C++20)

rotl (C++20)

rotr (C++20)

countl_zero (C++20)

countl_one (C++20)

countr_zero (C++20)

countr_one (C++20)

popcount (C++20)

endian (C++20)

 

std::complex

Member functions
complex::complex
complex::operator=
complex::real
complex::imag
complex::operator+=complex::operator-=complex::operator*=complex::operator/=
Non-member functions
operator+operator- operator+operator-operator*operator/ operator==operator!= (until C++20) operator<<operator>>	real imag abs arg norm conj proj (C++11) polar operator""ioperator""ifoperator""il (C++14)(C++14)(C++14)
Exponential functions
exp
log
log10
Power functions
pow
sqrt
Trigonometric functions
sin cos tan	asin (C++11) acos (C++11) atan (C++11)
Hyperbolic functions
sinh cosh tanh	asinh (C++11) acosh (C++11) atanh (C++11)

 

primary template 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 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 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 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.

1) Returns the imaginary part.

2) Sets the imaginary part to value.

Parameters

value

-

the value to set the imaginary part to

Return value

1) The imaginary part of *this.

2) (none)

Notes

In C++11, overload (1) in 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.

See also

imag	returns the imaginary component (function template)
real	accesses the real part of the complex number (public member function)