cbrt, cbrtf, cbrtl

 

C

言語

ヘッダ

型サポート

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

可変長引数サポート

エラー処理

動的メモリ管理

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

文字列ライブラリ

アルゴリズム

数値演算

入出力サポート

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

アトミック操作(C11)

スレッドサポート(C11)

技術仕様書

 

数値演算

一般的な数学関数

浮動小数点環境(C99)

複素数算術(C99)

乱数生成

型総称数学(C99)

 

一般的な数学関数

関数
基本操作
abslabsllabsimaxabs (C99) fabs divldivlldivimaxdiv (C99) fmod	remainder (C99) remquo (C99) fma (C99) fmax (C99) fmin (C99) fdim (C99) nannanfnanl (C99)(C99)(C99)
指数関数
exp exp2 (C99) expm1 (C99)	log log10 log1p (C99) log2 (C99)
冪関数
sqrt cbrt (C99)	hypot (C99) pow
三角関数と双曲線関数
sin cos tan asin acos atan atan2	sinh cosh tanh asinh (C99) acosh (C99) atanh (C99)
誤差関数とガンマ関数
erf (C99) erfc (C99)	lgamma (C99) tgamma (C99)
最も近い整数
ceil floor roundlroundllround (C99)(C99)(C99)	trunc (C99) nearbyint (C99) rintlrintllrint (C99)(C99)(C99)
浮動小数点操作関数
ldexp scalbnscalbln (C99)(C99) ilogb (C99) logb (C99)	frexp modf nextafternexttoward (C99)(C99) copysign (C99)
分類
fpclassify (C99) isfinite (C99) isinf (C99) isnan (C99) isnormal (C99) signbit (C99)	isgreater (C99) isgreaterequal (C99) isless (C99) islessequal (C99) islessgreater (C99) isunordered (C99)
型
div_tldiv_tlldiv_timaxdiv_t (C99)(C99)	float_tdouble_t (C99)(C99)
マクロ定数
HUGE_VALFHUGE_VALHUGE_VALL (C99)(C99) FP_FAST_FMAFFP_FAST_FMAFP_FAST_FMAL (C99)(C99)(C99) math_errhandlingMATH_ERRNOMATH_ERRNOEXCEPT (C99)(C99)(C99)	INFINITY (C99) NAN (C99) FP_ILOGB0FP_ILOGBNAN (C99)(C99) FP_NORMALFP_SUBNORMALFP_ZEROFP_INFINITEFP_NAN (C99)(C99)(C99)(C99)(C99)

 

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

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

4) 型総称マクロ。 arg が longdouble 型の場合は cbrtl が呼ばれます。 そうでなく、 arg が整数型または double 型の場合は cbrt が呼ばれます。 そうでなければ cbrtf が呼ばれます。

引数

arg

-

浮動小数点値

戻り値

エラーが発生しなければ、 arg の立方根 (\(\small{\sqrt[3]{arg} }\)3√arg) が返されます。

アンダーフローによる値域エラーが発生した場合、 (丸めた後の) 正確な値が返されます。

エラー処理

math_errhandling で規定されている通りにエラーが報告されます。

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

• 引数が ±0 または ±∞ であれば、それが変更されずに返されます。
• 引数が NaN であれば、 NaN が返されます。

ノート

有理数 \(\small{\frac1{3} }\)

1

3

は一般的に 1.0/3 と等しくなく、 std::pow は負の底に小数の指数を乗じることができないため、 cbrt(arg) は pow(arg, 1.0/3) と同等ではありません。 また、 cbrt(arg) は通常 pow(arg, 1.0/3) よりも正確な結果を返します (例を参照してください)。

例

Run this code

#include <stdio.h>#include <float.h>#include <math.h>   int main(void){// normal useprintf("cbrt(729) = %f\n", cbrt(729));printf("cbrt(-0.125) = %f\n", cbrt(-0.125));// special valuesprintf("cbrt(-0) = %f\n", cbrt(-0.0));printf("cbrt(+inf) = %f\n", cbrt(INFINITY));// accuracyprintf("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));}

出力例:

cbrt(729) = 9.000000 cbrt(-0.125) = -0.500000 cbrt(-0) = -0.000000 cbrt(+inf) = inf cbrt(343) = 7.00000000000000000 pow(343,1.0/3) = 6.99999999999999911

参考文献

• C11 standard (ISO/IEC 9899:2011):

• 7.12.7.1 The cbrt functions (p: 247)

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

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

• C99 standard (ISO/IEC 9899:1999):

• 7.12.7.1 The cbrt functions (p: 228)

• 7.22 Type-generic math <tgmath.h> (p: 335-337)

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

関連項目

powpowfpowl (C99)(C99)	x の y 乗 (\(\small{x^y}\)xy) を計算します (関数)
sqrtsqrtfsqrtl (C99)(C99)	平方根 (\(\small{\sqrt{x} }\)√x) を計算します (関数)
hypothypotfhypotl (C99)(C99)(C99)	2つの値の二乗和の平方根 (\(\scriptsize{\sqrt{x^2+y^2} }\)√x2 +y2 ) を計算します (関数)
cbrt の C++リファレンス