cexp2

Compute the base-2 exponential of a complex number.

Interface Definition

C interface:

float complex cexp2f(float complex x);

double complex cexp2(double complex x);

long double complex cexp2l(long double complex x);

Parameters

Parameter	Type	Description	Input/Output
x	For cexp2f, x is of complex single-precision floating-point type. For cexp2, x is of complex double-precision floating-point type. For cexp2l, x is of complex, long, double-precision floating-point type.	Floating-point value of the input data.	Input

Parameter

Type

Description

Input/Output

For cexp2f, x is of complex single-precision floating-point type.

For cexp2, x is of complex double-precision floating-point type.

For cexp2l, x is of complex, long, double-precision floating-point type.

Floating-point value of the input data.

Input

Return Value

The base-2 exponential y of x is returned.

The special values are listed in the following table.

Real Part of the Input (x.real)	Imaginary Part of the Input (x.imag)	Real Part of the Output (y.real)	Imaginary Part of the Output (y.imag)
+0	+0	+1	+0
+0	-0	+1	-0
+0	inf	NaN	NaN
+0	-inf	NaN	NaN
+0	SNaN	NaN	NaN
+0	–SNaN	NaN	NaN
+0	QNaN	NaN	NaN
+0	–QNaN	NaN	NaN
-0	+0	+1	+0
-0	-0	+1	-0
-0	inf	NaN	NaN
-0	-inf	NaN	NaN
-0	SNaN	NaN	NaN
-0	–SNaN	NaN	NaN
-0	QNaN	NaN	NaN
-0	–QNaN	NaN	NaN
inf	+0	inf	+0
inf	-0	inf	-0
inf	inf	inf	NaN
inf	-inf	inf	NaN
inf	SNaN	inf	NaN
inf	–SNaN	inf	NaN
inf	QNaN	inf	NaN
inf	–QNaN	inf	NaN
-inf	+0	+0	+0
-inf	-0	+0	-0
-inf	inf	+0	+0
-inf	-inf	+0	+0
-inf	SNaN	+0	+0
-inf	–SNaN	+0	+0
-inf	QNaN	+0	+0
-inf	–QNaN	+0	+0
SNaN	+0	NaN	+0
SNaN	-0	NaN	-0
SNaN	inf	NaN	NaN
SNaN	-inf	NaN	NaN
SNaN	SNaN	NaN	NaN
SNaN	–SNaN	NaN	NaN
SNaN	QNaN	NaN	NaN
SNaN	–QNaN	NaN	NaN
–SNaN	+0	NaN	+0
–SNaN	-0	NaN	-0
–SNaN	inf	NaN	NaN
–SNaN	-inf	NaN	NaN
–SNaN	SNaN	NaN	NaN
–SNaN	–SNaN	NaN	NaN
–SNaN	QNaN	NaN	NaN
–SNaN	–QNaN	NaN	NaN
QNaN	+0	NaN	+0
QNaN	-0	NaN	-0
QNaN	inf	NaN	NaN
QNaN	-inf	NaN	NaN
QNaN	SNaN	NaN	NaN
QNaN	–SNaN	NaN	NaN
QNaN	QNaN	NaN	NaN
QNaN	–QNaN	NaN	NaN
–QNaN	+0	NaN	+0
–QNaN	-0	NaN	-0
–QNaN	inf	NaN	NaN
–QNaN	-inf	NaN	NaN
–QNaN	SNaN	NaN	NaN
–QNaN	–SNaN	NaN	NaN
–QNaN	QNaN	NaN	NaN
–QNaN	–QNaN	NaN	NaN

Dependency

C: "kc.h"

Example

C interface:

    // typical usage
    double x1 = INFINITY, y1 = INFINITY;
    double x2 = 2.0, y2 = 3.0;
    double x3 = -2.5, y3 = -3.4;
    double x4 = NAN, y4 = NAN;
    double x5 = 0, y5 = 0;
    double complex z1 = cexp2(__builtin_complex(x1, y1));
    double complex z2 = cexp2(__builtin_complex(x2, y2));
    double complex z3 = cexp2(__builtin_complex(x3, y3));
    double complex z4 = cexp2(__builtin_complex(x4, y4));
    double complex z5 = cexp2(__builtin_complex(x5, y5));
    // print result
    printf("/*\n");
    printf(" * cexp2(%.2f + %.2f*I) = %.6f + %.6f*I\n", x1, y1, __real__(z1), __imag__(z1));
    printf(" * cexp2(%.2f + %.2f*I) = %.6f + %.6f*I\n", x2, y2, __real__(z2), __imag__(z2));
    printf(" * cexp2(%.2f + %.2f*I) = %.6f + %.6f*I\n", x3, y3, __real__(z3), __imag__(z3));
    printf(" * cexp2(%.2f + %.2f*I) = %.6f + %.6f*I\n", x4, y4, __real__(z4), __imag__(z4));
    printf(" * cexp2(%.2f + %.2f*I) = %.6f + %.6f*I\n", x5, y5, __real__(z5), __imag__(z5));
    printf(" **/\n");
 
   /*
    * cexp2(inf + inf*I) = inf + nan*I
    * cexp2(2.00 + 3.00*I) = -1.947978 + 3.493620*I
    * cexp2(-2.50 + -3.40*I) = -0.125063 + -0.124937*I
    * cexp2(nan + nan*I) = nan + nan*I
    * cexp2(0.00 + 0.00*I) = 1.000000 + 0.000000*I
    **/

Parent topic: Function Syntax