Complex number arithmetic
The header <complex.h>
defines macros and declares functions that support complex number arithmetic. Complex values are values of type double complex
, float complex
, long double complex
,
If the macro constant __STDC_IEC_559_COMPLEX__
(C99) is defined by the compiler, in addition to the complex types, the imaginary types are also supported: double imaginary
, float imaginary
, and long double imaginary
. When a value of imaginary type is converted to a value of complex type, the resulting complex type has its real component set to zero. When a value of complex type is converted to a value of imaginary type, the real component is discarded.
Standard arithmetic operators +, -, *, / can be used with real, complex, and imaginary types in any combination.
If the macro constant __STDC_NO_COMPLEX__
(C11) is defined by the compiler, the header <complex.h>
and all of the names listed here are not provided.
If #pragma STDC CX_LIMITED_RANGE on is used, complex multiplication, division, and absolute value may use simplified mathematical formulas, despite the possibility of intermediate overflow.
Defined in header
<complex.h> | ||
Types | ||
(C99) |
complex type macro (keyword macro) | |
(C99) |
the complex unit constant i (macro constant) | |
The imaginary constant | ||
(C99) |
imaginary type macro (keyword macro) | |
(C99) |
the imaginary unit constant i (macro constant) | |
(C99) |
the complex or imaginary unit constant i (macro constant) | |
Manipulation | ||
(C11)(C11)(C11) |
constructs a complex number from real and imaginary parts (function macro) | |
(C99)(C99)(C99) |
computes the imaginary part a complex number (function) | |
(C99)(C99)(C99) |
computes the real part of a complex number (function) | |
(C99)(C99)(C99) |
computes the phase angle of a complex number (function) | |
(C99)(C99)(C99) |
computes the complex conjugate (function) | |
(C99)(C99)(C99) |
computes the projection on Riemann sphere (function) | |
(C99)(C99)(C99) |
computes the magnitude of a complex number (function) | |
Exponential functinos | ||
(C99)(C99)(C99) |
computes the complex base-e exponential (function) | |
(C99)(C99)(C99) |
computes the complex natural logarithm (function) | |
Power functions | ||
(C99)(C99)(C99) |
computes the complex power function (function) | |
(C99)(C99)(C99) |
computes the complex square root (function) | |
Trigonometric functions | ||
(C99)(C99)(C99) |
computes the complex arc cosine (function) | |
(C99)(C99)(C99) |
computes the complex arc sine (function) | |
(C99)(C99)(C99) |
computes the complex arc tangent (function) | |
(C99)(C99)(C99) |
computes the complex cosine (function) | |
(C99)(C99)(C99) |
computes the complex sine (function) | |
(C99)(C99)(C99) |
computes the complex tangent (function) | |
Hyperbolic functions | ||
(C99)(C99)(C99) |
computes the complex arc hyperbolic cosine (function) | |
(C99)(C99)(C99) |
computes the complex arc hyperbolic sine (function) | |
(C99)(C99)(C99) |
computes the complex arc hyperbolic tangent (function) | |
(C99)(C99)(C99) |
computes the complex hyperbolic cosine (function) | |
(C99)(C99)(C99) |
computes the complex hyperbolic sine (function) | |
(C99)(C99)(C99) |
computes the complex hyperbolic tangent (function) |
Example
#include <stdio.h> /* printf */ #include <complex.h> /* complex, float complex, I, ... */ int main () { #ifdef __STDC_IEC_559_COMPLEX__ printf("_STDC_IEC_559_COMPLEX__ defined\n"); #else printf("_STDC_IEC_559_COMPLEX__ not defined\n"); #endif #ifdef __STDC_NO_COMPLEX__ printf("__STDC_NO_COMPLEX__ defined\n"); #else printf("__STDC_NO_COMPLEX__ not defined\n"); #endif printf("\n"); printf("%2zu\n", sizeof(complex)); /* 16 */ printf("%2zu\n", sizeof(float complex)); /* 8 */ printf("%2zu\n", sizeof(double complex)); /* 16 */ printf("%2zu\n", sizeof(long double complex)); /* implementation-defined */ /* Two macros represent the complex number “0+1i”. */ printf("%f + %fi\n", creal(1.0*I*1.0*I),cimag(1.0*I*1.0*I)); printf("%f + %fi\n", creal(1.0*_Complex_I*1.0*_Complex_I), cimag(1.0*_Complex_I*1.0*_Complex_I)); /* Use the macros to define complex constants. */ complex z1 = 1.0 + 2.0*I; complex z2 = 2.0 + 4.0*_Complex_I; /* Sum and print. */ complex z3 = z1+z2; printf("%f + %fi\n", creal(z3),cimag(z3)); return 0; }
Output:
_STDC_IEC_559_COMPLEX__ defined __STDC_NO_COMPLEX__ not defined 16 8 16 32 -1.000000 + 0.000000i -1.000000 + 0.000000i 3.000000 + 6.000000i