conj-conjf-conjl.md

title	conj, conjf, conjl
description	API reference for conj, conjf, and conjl; which retrieve the complex conjugate of a complex number.
ms.date	9/2/2020
api_name	conj conjf conjl
api_location	msvcrt.dll msvcr80.dll msvcr90.dll msvcr100.dll msvcr100_clr0400.dll msvcr110.dll msvcr110_clr0400.dll msvcr120.dll msvcr120_clr0400.dll ucrtbase.dll api-ms-win-crt-math-l1-1-0.dll
api_type	DLLExport
topic_type	apiref
f1_keywords	conj conjf conjl complex/conj complex/conjf complex/conjl
helpviewer_keywords	conj function conjf function conjl function

conj, conjf, conjl

Retrieves the complex conjugate of a complex number.

Syntax

_Dcomplex conj(
   _Dcomplex z
);
_Fcomplex conj(
   _Fcomplex z
);  // C++ only
_Lcomplex conj(
   _Lcomplex z
);  // C++ only
_Fcomplex conjf(
   _Fcomplex z
);
_Lcomplex conjl(
   _Lcomplex z
);
#define conj(X) // Requires C11 or later

Parameters

z
A complex number.

Return value

The complex conjugate of z. The result has the same real and imaginary part as z, but with the opposite sign.

Remarks

Because C++ allows overloading, you can call overloads of conj that take and return _Fcomplex and _Lcomplex values. In a C program, unless you're using the <tgmath.h> macro to call this function, conj always takes and returns a _Dcomplex value.

If you use the <tgmath.h> conj() macro, the type of the argument determines which version of the function is selected. See Type-generic math for details.

Requirements

Routine	C header	C++ header
conj, conjf, conjl	<complex.h>	<ccomplex>
conj macro	<tgmath.h>

For more compatibility information, see Compatibility.

See also

Alphabetical function reference
norm, normf, norml
creal, crealf, creall
cproj, cprojf, cprojl
cimag, cimagf, cimagl
carg, cargf, cargl
cabs, cabsf, cabsl