cbrt, cbrtf, cbrtl

 

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)

 

Allgemeine mathematische Funktionen

Funktionen Grundlegende Operationen abslabsllabsimaxabs (C99)(C99) fabs divldivlldivimaxdiv (C99)(C99) fmod remainder (C99) remquo (C99) fma (C99) fdim (C99) nannanfnanlnandN (C99)(C99)(C99)(C23) Maximum/Minimum-Operationen fmax (C99) fmin (C99) fmaximum (C23) fminimum (C23) fmaximum_mag (C23)  fmaximum_num (C23) fminimum_mag (C23) fminimum_num (C23) fmaximum_mag_num (C23) fminimum_mag_num (C23)   Exponentialfunktionen exp exp10 (C23) exp2 (C99) expm1 (C99) exp10m1 (C23) exp2m1 (C23) log log10 log2 (C99) log1plogp1 (C99)(C23) log10p1 (C23) log2p1 (C23) Potenzfunktionen sqrt cbrt (C99) rootn (C23) rsqrt (C23) hypot (C99) compound (C23) pow pown (C23) powr (C23) Trigonometrische und hyperbolische Funktionen sin cos tan asin acos atan atan2 sinpi (C23) cospi (C23) tanpi (C23) asinpi (C23) acospi (C23) atanpi (C23) atan2pi (C23) sinh cosh tanh asinh (C99) acosh (C99) atanh (C99)

Nächste ganze Gleitkommazahlen ceil floor roundlroundllround (C99)(C99)(C99) roundeven (C23) trunc (C99) nearbyint (C99) rintlrintllrint (C99)(C99)(C99) fromfpfromfpxufromfpufromfpx (C23)(C23)(C23)(C23) Gleitkomma-Manipulation ldexp frexp scalbnscalbln (C99)(C99) ilogbllogb (C99)(C23) logb (C99) modf nextafternexttoward (C99)(C99) nextupnextdown (C23)(C23) copysign (C99) canonicalize (C23) Verengende Operationen fadd (C23) fsub (C23) fmul (C23) fdiv (C23) ffma (C23) fsqrt (C23) Quanten- und Quantenexponent-Funktionen quantizedN (C23) quantumdN (C23) samequantumdN (C23) llquantexpdN (C23) Dezimal-Neu-Kodierungsfunktionen encodedecdN (C23) decodedecdN (C23) encodebindN (C23) decodebindN (C23) Gesamtordnung und Payload-Funktionen totalorder (C23) getpayload (C23) setpayload (C23) setpayloadsig (C23) Klassifizierung fpclassify (C99) iscanonical (C23)  isfinite (C99) isinf (C99) isnan (C99) isnormal (C99) signbit (C99) issubnormal (C23) iszero (C23) isgreater (C99) isgreaterequal (C99)   isless (C99) islessequal (C99) islessgreater (C99) isunordered (C99) issignaling (C23) iseqsig (C23)

Fehler- und Gammafunktionen erf (C99) erfc (C99) lgamma (C99) tgamma (C99) Typen div_tldiv_tlldiv_timaxdiv_t (C99)(C99) float_tdouble_t (C99)(C99) _Decimal32_t_Decimal64_t (C23)(C23) Makrokonstanten Spezielle Gleitkommawerte HUGE_VALHUGE_VALFHUGE_VALLHUGE_VALDN (C99)(C99)(C23) INFINITYDEC_INFINITY (C99)(C23) NANDEC_NAN (C99)(C23) Argumente und Rückgabewerte FP_ILOGB0FP_ILOGBNAN (C99)(C99) FP_NORMALFP_SUBNORMALFP_ZEROFP_INFINITEFP_NAN (C99)(C99)(C99)(C99)(C99) FP_LLOGB0FP_LLOGBNAN (C23)(C23) FP_INT_UPWARDFP_INT_DOWNWARDFP_INT_TOWARDZEROFP_INT_TONEARESTFROMZEROFP_INT_TONEAREST (C23)(C23)(C23)(C23)(C23) Fehlerbehandlung MATH_ERRNOMATH_ERRNOEXCEPT (C99)(C99)  math_errhandling (C99) Schnelle Operationsanzeigen FP_FAST_FMAFFP_FAST_FMA (C99)(C99) FP_FAST_FADDFP_FAST_FADDLFP_FAST_DADDLFP_FAST_DMADDDN (C23)(C23)(C23)(C23) FP_FAST_FMULFP_FAST_FMULLFP_FAST_DMULLFP_FAST_DMMULDN (C23)(C23)(C23)(C23) FP_FAST_FFMAFP_FAST_FFMALFP_FAST_DFMALFP_FAST_DMFMADN (C23)(C23)(C23)(C23) FP_FAST_FMALFP_FAST_FMADN (C99)(C23) FP_FAST_FSUBFP_FAST_FSUBLFP_FAST_DSUBLFP_FAST_DMSUBDN (C23)(C23)(C23)(C23) FP_FAST_FDIVFP_FAST_FDIVLFP_FAST_DDIVLFP_FAST_DMDIVDN (C23)(C23)(C23)(C23) FP_FAST_FSQRTFP_FAST_FSQRTLFP_FAST_DSQRTLFP_FAST_DMSQRTDN (C23)(C23)(C23)(C23)

 

Definiert in Header <math.h>
float       cbrtf( float arg );	(1)	(seit C99)
double      cbrt( double arg );	(2)	(seit C99)
long double cbrtl( long double arg );	(3)	(seit C99)
Definiert in Header <tgmath.h>
#define cbrt( arg )	(4)	(seit C99)

1-3) Berechnet die Kubikwurzel von arg.

4) Typgenerische Makro: Wenn arg vom Typ long double ist, wird cbrtl aufgerufen. Andernfalls, wenn arg einen Ganzzahltyp oder den Typ double hat, wird cbrt aufgerufen. Andernfalls wird cbrtf aufgerufen.

Parameter

arg

-

Gleitkommawert

Rückgabewert

Wenn keine Fehler auftreten, wird die Kubikwurzel von arg (\(\small{\sqrt[3]{arg} }\)3√arg) zurückgegeben.

Wenn ein Bereichsfehler aufgrund eines Unterlaufs auftritt, wird das korrekte Ergebnis (nach Rundung) zurückgegeben.

Fehlerbehandlung

Fehler werden wie in math_errhandling angegeben gemeldet.

Wenn die Implementierung IEEE-Gleitkomma-Arithmetik (IEC 60559) unterstützt,

• Wenn das Argument ±0 oder ±∞ ist, wird es unverändert zurückgegeben.
• Wenn das Argument NaN ist, wird NaN zurückgegeben.

Hinweise

cbrt(arg) ist nicht äquivalent zu pow(arg, 1.0/3), da die rationale Zahl \(\small{\frac1{3} }\)

1

3

typischerweise nicht gleich 1.0/3 ist und std::pow eine negative Basis nicht mit einem gebrochenen Exponenten potenzieren kann. Darüber hinaus liefert cbrt(arg) normalerweise genauere Ergebnisse als pow(arg, 1.0/3) (siehe Beispiel).

Beispiel

Führen Sie diesen Code aus

#include <float.h>
#include <math.h>
#include <stdio.h>
 
int main(void)
{
    printf("Normal use:\n"
           "cbrt(729)      = %f\n", cbrt(729));
    printf("cbrt(-0.125)   = %f\n", cbrt(-0.125));
    printf("Special values:\n"
           "cbrt(-0)       = %f\n", cbrt(-0.0));
    printf("cbrt(+inf)     = %f\n", cbrt(INFINITY));
    printf("Accuracy:\n"
           "cbrt(343)      = %.*f\n", DBL_DECIMAL_DIG, cbrt(343));
    printf("pow(343,1.0/3) = %.*f\n", DBL_DECIMAL_DIG, pow(343, 1.0/3));
}

Mögliche Ausgabe

Normal use:
cbrt(729)      = 9.000000
cbrt(-0.125)   = -0.500000
Special values:
cbrt(-0)       = -0.000000
cbrt(+inf)     = inf
Accuracy:
cbrt(343)      = 7.00000000000000000
pow(343,1.0/3) = 6.99999999999999911

Referenzen

• C23-Standard (ISO/IEC 9899:2024)

• 7.12.7.1 Die cbrt-Funktionen (S. TBD)

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

• F.10.4.1 Die cbrt-Funktionen (S. TBD)

• C17-Standard (ISO/IEC 9899:2018)

• 7.12.7.1 Die cbrt-Funktionen (S. 180-181)

• 7.25 Typ-generische Mathematik <tgmath.h> (S. 272-273)

• F.10.4.1 Die cbrt-Funktionen (S. 381-)

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

• 7.12.7.1 Die cbrt-Funktionen (S. 247)

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

• F.10.4.1 Die cbrt-Funktionen (S. 524)

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

• 7.12.7.1 Die cbrt-Funktionen (S. 228)

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

• F.9.4.1 Die cbrt-Funktionen (S. 460)

Siehe auch

powpowfpowl (C99)(C99)	berechnet eine Zahl hoch die gegebene Potenz (\(\small{x^y}\)xy) (Funktion)
sqrtsqrtfsqrtl (C99)(C99)	berechnet die Quadratwurzel (\(\small{\sqrt{x} }\)√x) (Funktion)
hypothypotfhypotl (C99)(C99)(C99)	berechnet die Quadratwurzel der Summe der Quadrate zweier gegebener Zahlen (\(\scriptsize{\sqrt{x^2+y^2} }\)√x2 +y2 ) (Funktion)
C++-Dokumentation für cbrt