cpowf, cpow, cpowl

 

C

Compiler-Unterstützung

Sprache

Header

Typunterstützung

Programm-Dienstprogramme

Unterstützung für variable Funktionsargumente

Fehlerbehandlung

Dynamische Speicherverwaltung

Bibliothek für Zeichenketten

Algorithmen

Numerik

Datums- und Zeitdienstprogramme

Ein-/Ausgabeunterstützung

Lokalisierungsunterstützung

Unterstützung für Nebenläufigkeit (C11)

Technische Spezifikationen

Symbolindex

 

Numerik

Allgemeine mathematische Funktionen

Gleitkomma-Umgebung (C99)

Pseudozufallszahlengenerierung

Komplexe Arithmetik (C99)

Typ-generierte Mathematik (C99)

Bitmanipulation (C23)

Geprüfte Ganzzahl-Arithmetik (C23)

 

Arithmetik mit komplexen Zahlen

Typen und die imaginäre Konstante
complex (C99) _Complex_I (C99)     CMPLX (C11)	imaginary (C99) _Imaginary_I (C99) I (C99)
Manipulation
cimag (C99) creal (C99) carg (C99)	cabs (C99) conj (C99) cproj (C99)
Potenz- und Exponentialfunktionen
cexp (C99) clog (C99)	cpow (C99) csqrt (C99)
Trigonometrische Funktionen
ccos (C99) csin (C99) ctan (C99)	cacos (C99) casin (C99) catan (C99)
Hyperbolische Funktionen
ccosh (C99) csinh (C99) ctanh (C99)	cacosh (C99) casinh (C99) catanh (C99)

 

Definiert im Header <complex.h>
float complex       cpowf( float complex x, float complex y );	(1)	(seit C99)
double complex      cpow( double complex x, double complex y );	(2)	(seit C99)
long double complex cpowl( long double complex x, long double complex y );	(3)	(seit C99)
Definiert in Header <tgmath.h>
#define pow( x, y )	(4)	(seit C99)

1-3) Berechnet die komplexe Potenzfunktion xy
mit dem Zweigschnitt für den ersten Parameter entlang der negativen reellen Achse.

4) Typ-generische Makro: Wenn ein Argument vom Typ long double complex ist, wird cpowl aufgerufen. Wenn ein Argument vom Typ double complex ist, wird cpow aufgerufen. Wenn ein Argument vom Typ float complex ist, wird cpowf aufgerufen. Wenn die Argumente reell oder ganzzahlig sind, ruft das Makro die entsprechende reelle Funktion (powf, pow, powl) auf. Wenn ein Argument imaginär ist, wird die entsprechende komplexe Version aufgerufen.

Parameter

x, y

-

complex argument

Rückgabewert

Wenn keine Fehler auftreten, wird die komplexe Potenz xy
zurückgegeben.

Fehler und Sonderfälle werden behandelt, als ob die Operation durch cexp(y*clog(x)) implementiert wäre, wobei die Implementierung Sonderfälle sorgfältiger behandeln darf.

Beispiel

Führen Sie diesen Code aus

#include <stdio.h>
#include <complex.h>
 
int main(void)
{    
    double complex z = cpow(1.0+2.0*I, 2);
    printf("(1+2i)^2 = %.1f%+.1fi\n", creal(z), cimag(z));
 
    double complex z2 = cpow(-1, 0.5);
    printf("(-1+0i)^0.5 = %.1f%+.1fi\n", creal(z2), cimag(z2));
 
    double complex z3 = cpow(conj(-1), 0.5); // other side of the cut
    printf("(-1-0i)^0.5 = %.1f%+.1fi\n", creal(z3), cimag(z3));
 
    double complex z4 = cpow(I, I); // i^i = exp(-pi/2)
    printf("i^i = %f%+fi\n", creal(z4), cimag(z4));
}

Ausgabe

(1+2i)^2 = -3.0+4.0i
(-1+0i)^0.5 = 0.0+1.0i
(-1-0i)^0.5 = 0.0-1.0i
i^i = 0.207880+0.000000i

Referenzen

• C11-Standard (ISO/IEC 9899:2011)

• 7.3.8.2 Die cpow-Funktionen (S. 195-196)

• 7.25 Typ-generische Mathematik <tgmath.h> (S. 373-375)

• G.6.4.1 Die cpow-Funktionen (S. 544)

• G.7 Type-generic math <tgmath.h> (S: 545)

• C99-Standard (ISO/IEC 9899:1999)

• 7.3.8.2 Die cpow-Funktionen (S. 177)

• 7.22 Typ-generische Mathematik <tgmath.h> (S. 335-337)

• G.6.4.1 Die cpow-Funktionen (S. 479)

• G.7 Type-generic math <tgmath.h> (S: 480)

Siehe auch

csqrtcsqrtfcsqrtl (C99)(C99)(C99)	berechnet die komplexe Quadratwurzel (Funktion)
powpowfpowl (C99)(C99)	berechnet eine Zahl hoch die gegebene Potenz (\(\small{x^y}\)xy) (Funktion)
C++ Dokumentation für pow