std::conj(std::complex)

 

C++

Language

Standard Library Headers

Freestanding and hosted implementations

Named requirements

Language support library

Concepts library (C++20)

Diagnostics library

Utilities library

Strings library

Containers library

Iterators library

Ranges library (C++20)

Algorithms library

Numerics library

Input/output library

Localizations library

Regular expressions library (C++11)

Atomic operations library (C++11)

Thread support library (C++11)

Filesystem library (C++17)

Technical Specifications

 

Numerics library

Common mathematical functions

Special mathematical functions

Floating-point environment (C++11)

Complex numbers

Numeric arrays

Pseudo-random number generation

Compile-time rational arithmetic (C++11)

Numeric algorithms

gcd (C++17)

lcm (C++17)

Interpolations

midpoint (C++20)

lerp (C++20)

Generic numeric operations

iota (C++11)

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)

ispow2 (C++20)

ceil2 (C++20)

floor2 (C++20)

log2p1 (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!= 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)

 

Defined in header <complex>
	(1)
template< class T > std::complex<T> conj( const std::complex<T>& z );			(until C++20)
template< class T > constexpr std::complex<T> conj( const std::complex<T>& z );			(since C++20)
		(2)
std::complex<float> conj( float z ); template< class DoubleOrInteger > std::complex<double> conj( DoubleOrInteger z ); std::complex<long double> conj( long double z );				(since C++11) (until C++20)
constexpr std::complex<float> conj( float z ); template< class DoubleOrInteger > constexpr std::complex<double> conj( DoubleOrInteger z ); constexpr std::complex<long double> conj( long double z );				(since C++20)

1) Computes the complex conjugate of z by reversing the sign of the imaginary part.

2) Additional overloads are provided for float, double, long double, and all integer types, which are treated as complex numbers with zero imaginary component.

(since C++11)

Parameters

z

-

complex value

Return value

The complex conjugate of z

Example

Run this code

#include <iostream>
#include <complex>
 
int main()
{
    std::complex<double> z(1,2);
    std::cout << "The conjugate of " << z << " is " << std::conj(z) << '\n'
              << "Their product is " << z*std::conj(z) << '\n';
}

Output:

The conjugate of (1,2) is (1,-2)
Their product is (5,0)

See also

abs(std::complex)	returns the magnitude of a complex number (function template)
norm	returns the squared magnitude (function template)
polar	constructs a complex number from magnitude and phase angle (function template)