csqrtf, csqrt, csqrtl

 

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       csqrtf( float complex z );	(1)	(seit C99)
double complex      csqrt( double complex z );	(2)	(seit C99)
long double complex csqrtl( long double complex z );	(3)	(seit C99)
Definiert in Header <tgmath.h>
#define sqrt( z )	(4)	(seit C99)

1-3) Berechnet die komplexe Quadratwurzel von z mit dem Schnitt entlang der negativen reellen Achse.

4) Typ-generische Makro: Wenn z vom Typ long double complex ist, wird csqrtl aufgerufen. Wenn z vom Typ double complex ist, wird csqrt aufgerufen. Wenn z vom Typ float complex ist, wird csqrtf aufgerufen. Wenn z reell oder ganzzahlig ist, ruft das Makro die entsprechende reelle Funktion auf (sqrtf, sqrt, sqrtl). Wenn z imaginär ist, wird die entsprechende komplexe Version aufgerufen.

Parameter

z

-

complex argument

Rückgabewert

Wenn keine Fehler auftreten, wird die Quadratwurzel von z zurückgegeben, im Bereich der rechten Halbebene, einschließlich der imaginären Achse ([0; +∞) entlang der reellen Achse und (−∞; +∞) entlang der imaginären Achse.)

Fehlerbehandlung und Sonderwerte

Fehler werden konsistent mit math_errhandling gemeldet.

Wenn die Implementierung IEEE-Gleitkomma-Arithmetik unterstützt,

• Die Funktion ist kontinuierlich auf dem Schnitt, unter Berücksichtigung des Vorzeichens des Imaginärteils
• csqrt(conj(z)) == conj(csqrt(z))
• Wenn z ±0+0i ist, ist das Ergebnis +0+0i
• Wenn z x+∞i ist, ist das Ergebnis +∞+∞i, auch wenn x NaN ist
• Wenn z x+NaNi ist, ist das Ergebnis NaN+NaNi (es sei denn, x ist ±∞) und FE_INVALID kann ausgelöst werden
• Wenn z -∞+yi ist, ist das Ergebnis +0+∞i für endliches positives y
• Wenn z +∞+yi ist, ist das Ergebnis +∞+0i) für endliches positives y
• Wenn z -∞+NaNi ist, ist das Ergebnis NaN±∞i (Vorzeichen des Imaginärteils nicht spezifiziert)
• Wenn z +∞+NaNi ist, ist das Ergebnis +∞+NaNi
• Wenn z NaN+yi ist, ist das Ergebnis NaN+NaNi und FE_INVALID kann ausgelöst werden
• Wenn z NaN+NaNi ist, ist das Ergebnis NaN+NaNi.

Beispiel

Führen Sie diesen Code aus

#include <stdio.h>
#include <complex.h>
 
int main(void)
{
    double complex z1 = csqrt(-4);
    printf("Square root of -4 is %.1f%+.1fi\n", creal(z1), cimag(z1));
 
    double complex z2 = csqrt(conj(-4)); // or, in C11, CMPLX(-4, -0.0)
    printf("Square root of -4-0i, the other side of the cut, is "
           "%.1f%+.1fi\n", creal(z2), cimag(z2));
}

Ausgabe

Square root of -4 is 0.0+2.0i
Square root of -4-0i, the other side of the cut, is 0.0-2.0i

Referenzen

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

• 7.3.8.3 The csqrt functions (S. 196)

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

• G.6.4.2 The csqrt functions (S. 544)

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

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

• 7.3.8.3 The csqrt functions (S. 178)

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

• G.6.4.2 The csqrt functions (S. 479)

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

Siehe auch

cpowcpowfcpowl (C99)(C99)(C99)	berechnet die komplexe Potenzfunktion (Funktion)
sqrtsqrtfsqrtl (C99)(C99)	berechnet die Quadratwurzel (\(\small{\sqrt{x} }\)√x) (Funktion)
C++ Dokumentation für sqrt