cbrt, cbrtf, cbrtl

 

C

コンパイラサポート

言語

ヘッダー

型サポート

プログラムユーティリティ

可変長引数関数のサポート

エラーハンドリング

動的メモリ管理

文字列ライブラリ

アルゴリズム

数値

日付と時刻のユーティリティ

入出力サポート

ローカライゼーションサポート

並行処理サポート (C11)

技術仕様

シンボルインデックス

 

数値

共通の数学関数

浮動小数点環境 (C99)

擬似乱数生成

複素数演算 (C99)

型ジェネリックな数学関数 (C99)

ビット操作 (C23)

整数オーバーフロー検査 (C23)

 

共通の数学関数

関数 基本的な数学関数 abslabsllabsimaxabs (C99)(C99) fabs divldivlldivimaxdiv (C99)(C99) fmod remainder (C99) remquo (C99) fma (C99) fdim (C99) nannanfnanlnandN (C99)(C99)(C99)(C23) 最大/最小演算 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)   指数関数 exp exp10 (C23) exp2 (C99) expm1 (C99) exp10m1 (C23) exp2m1 (C23) log log10 log2 (C99) log1plogp1 (C99)(C23) log10p1 (C23) log2p1 (C23) べき乗関数 sqrt cbrt (C99) rootn (C23) rsqrt (C23) hypot (C99) compound (C23) pow pown (C23) powr (C23) 三角関数と双曲線関数 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)

最も近い整数浮動小数点数 ceil floor roundlroundllround (C99)(C99)(C99) roundeven (C23) trunc (C99) nearbyint (C99) rintlrintllrint (C99)(C99)(C99) fromfpfromfpxufromfpufromfpx (C23)(C23)(C23)(C23) 浮動小数点操作 ldexp frexp scalbnscalbln (C99)(C99) ilogbllogb (C99)(C23) logb (C99) modf nextafternexttoward (C99)(C99) nextupnextdown (C23)(C23) copysign (C99) canonicalize (C23) 縮小演算 fadd (C23) fsub (C23) fmul (C23) fdiv (C23) ffma (C23) fsqrt (C23) 量子および量子指数 quantizedN (C23) quantumdN (C23) samequantumdN (C23) llquantexpdN (C23) Decimal再エンコーディング関数 encodedecdN (C23) decodedecdN (C23) encodebindN (C23) decodebindN (C23) 総順序およびペイロード関数 totalorder (C23) getpayload (C23) setpayload (C23) setpayloadsig (C23) 分類 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)

誤差関数とガンマ関数 erf (C99) erfc (C99) lgamma (C99) tgamma (C99) 型 div_tldiv_tlldiv_timaxdiv_t (C99)(C99) float_tdouble_t (C99)(C99) _Decimal32_t_Decimal64_t (C23)(C23) マクロ定数 特殊な浮動小数点値 HUGE_VALHUGE_VALFHUGE_VALLHUGE_VALDN (C99)(C99)(C23) INFINITYDEC_INFINITY (C99)(C23) NANDEC_NAN (C99)(C23) 引数と戻り値 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) エラーハンドリング MATH_ERRNOMATH_ERRNOEXCEPT (C99)(C99)  math_errhandling (C99) 高速演算インジケータ 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)

 

ヘッダー <math.h> で定義
float       cbrtf( float arg );	(1)	(C99以降)
double      cbrt( double arg );	(2)	(C99以降)
long double cbrtl( long double arg );	(3)	(C99以降)
ヘッダー <tgmath.h> で定義
#define cbrt( arg )	(4)	(C99以降)

1-3) arg の立方根を計算します。

4) 型汎用マクロ: arg の型が long double の場合、cbrtl が呼び出されます。そうでなく、arg の型が整数型または double の場合、cbrt が呼び出されます。それ以外の場合、cbrtf が呼び出されます。

パラメータ

arg

-

floating-point value

戻り値

エラーが発生しなかった場合、arg の立方根（\(\small{\sqrt[3]{arg} }\)3√arg）が返されます。

アンダーフローによる範囲エラーが発生した場合、正確な結果 (丸め後) が返される。

エラー処理

math_errhandling で指定されたとおりにエラーが報告されます。

実装がIEEE浮動小数点算術 (IEC 60559) をサポートしている場合、

• 引数が ±0 または ±∞ の場合、変更されずに返されます。
• 引数が NaN の場合、NaN が返されます。

注意

cbrt(arg) は pow(arg, 1.0/3) と同等ではありません。なぜなら、有理数 \(\small{\frac1{3} }\)

1

3

は通常 1.0/3 と等しくなく、std::pow は負の基数を分数指数で累乗できないからです。さらに、cbrt(arg) は通常、pow(arg, 1.0/3) よりも正確な結果を生成します（例を参照）。

例

このコードを実行

#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));
}

実行結果の例

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

参照

• C23標準 (ISO/IEC 9899:2024)

• 7.12.7.1 The cbrt functions (p: TBD)

• 7.25 Type-generic math <tgmath.h> (p: TBD)

• F.10.4.1 The cbrt functions (p: TBD)

• C17標準 (ISO/IEC 9899:2018)

• 7.12.7.1 The cbrt functions (p: 180-181)

• 7.25 型総称数学関数 <tgmath.h> (p: 272-273)

• F.10.4.1 The cbrt functions (p: 381-)

• C11標準 (ISO/IEC 9899:2011)

• 7.12.7.1 The cbrt functions (p: 247)

• 7.25 型総称数学関数 <tgmath.h> (p: 373-375)

• F.10.4.1 The cbrt functions (p: 524)

• C99標準 (ISO/IEC 9899:1999)

• 7.12.7.1 The cbrt functions (p: 228)

• 7.22 型総称数学関数 <tgmath.h> (p: 335-337)

• F.9.4.1 The cbrt functions (p: 460)

関連項目

powpowfpowl (C99)(C99)	指定されたべき乗の数を計算する (\(\small{x^y}\)xy) (関数)
sqrtsqrtfsqrtl (C99)(C99)	平方根を計算する (\(\small{\sqrt{x} }\)√x) (関数)
hypothypotfhypotl (C99)(C99)(C99)	2つの与えられた数の平方の和の平方根を計算する (\(\scriptsize{\sqrt{x^2+y^2} }\)√x2 +y2 ) (関数)
C++ ドキュメント cbrt