cbrt, cbrtf, cbrtl

类型

div_tldiv_tlldiv_timaxdiv_t (C99)(C99)

float_tdouble_t (C99)(C99)
_Decimal32_t_Decimal64_t (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)
fmaximum (C23)
fmaximum_mag (C23)
fmaximum_num (C23)
fmaximum_mag_num (C23)

fmin (C99)
fminimum (C23)
fminimum_mag (C23)
fminimum_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)

误差及伽马函数

erf (C99)
erfc (C99)

lgamma (C99)
tgamma (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)
samequantumdN (C23)

quantumdN (C23)
llquantexpdN (C23)

十进制重编码函数

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)

宏常量

特殊浮点值

HUGE_VALFHUGE_VALHUGE_VALLHUGE_VALDN

(C99)(C99)(C23)

INFINITYDEC_INFINITY (C99)(C23)
NANDEC_NAN (C99)(C23)

参数与返回值

FP_ILOGB0FP_ILOGBNAN (C99)(C99)
FP_INT_UPWARDFP_INT_DOWNWARDFP_INT_TOWARDZEROFP_INT_TONEARESTFROMZEROFP_INT_TONEAREST (C23)(C23)(C23)(C23)(C23)

FP_LLOGB0FP_LLOGBNAN (C23)(C23)
FP_NORMALFP_SUBNORMALFP_ZEROFP_INFINITEFP_NAN (C99)(C99)(C99)(C99)(C99)

错误处理

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

-

浮点值

返回值

若不出现错误，则返回 arg 的立方根（$\small{\sqrt[3]{arg} }$ $3 \sqrt arg$ ）。

若出现下溢所致的错误，则返回（舍入后的）正确结果。

错误处理

报告 math_errhandling 中指定的错误。

若实现支持 IEEE 浮点算术（ IEC 60559 ），则

若参数为 ±0 或 ±∞ ，则返回不更改的参数
若参数为 NaN ，则返回 NaN 。

注解

cbrt(arg) 不等价于 pow(arg, 1.0/3)，因为有理数

13

通常不等于 1.0/3 并且 pow 不能求负底数的小数次幂。另外 cbrt(arg) 常给出比 pow(arg, 1.0/3) 更精确的结果（见示例）。

示例

运行此代码

#include <float.h>
#include <math.h>
#include <stdio.h>
 
int main(void)
{
    printf("普通用法:\n"
           "cbrt(729)      = %f\n", cbrt(729));
    printf("cbrt(-0.125)   = %f\n", cbrt(-0.125));
    printf("特殊值:\n"
           "cbrt(-0)       = %f\n", cbrt(-0.0));
    printf("cbrt(+inf)     = %f\n", cbrt(INFINITY));
    printf("精度:\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));
}

可能的输出：

普通用法:
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

引用

C23 标准（ISO/IEC 9899:2024）：

7.12.7.1 The cbrt functions （第 TBD 页）

7.25 Type-generic math <tgmath.h> （第 TBD 页）

F.10.4.1 The cbrt functions （第 TBD 页）

C17 标准（ISO/IEC 9899:2018）：

7.12.7.1 The cbrt functions （第 180-181 页）

7.25 Type-generic math <tgmath.h> （第 272-273 页）

F.10.4.1 The cbrt functions （第 381- 页）

C11 标准（ISO/IEC 9899:2011）：

7.12.7.1 The cbrt functions （第 247 页）

7.25 Type-generic math <tgmath.h> （第 373-375 页）

F.10.4.1 The cbrt functions （第 524 页）

C99 标准（ISO/IEC 9899:1999）：

7.12.7.1 The cbrt functions （第 228 页）

7.22 Type-generic math <tgmath.h> （第 335-337 页）

F.9.4.1 The cbrt functions （第 460 页）

参阅

powpowfpowl (C99)(C99)	计算一个数的给定次幂（$\small{x^y}$ $x y$ ） (函数)
sqrtsqrtfsqrtl (C99)(C99)	计算平方根（$\small{\sqrt{x} }$ $\sqrt x$ ） (函数)
hypothypotfhypotl (C99)(C99)(C99)	计算两个给定数平方和的平方根（$\scriptsize{\sqrt{x^2+y^2} }$ $\sqrt x 2 +y 2$ ） (函数)

编译器支持
语言
头文件
类型支持
程序工具
变参数函数支持
错误处理
动态内存管理
字符串库
算法
数值
日期和时间工具
输入/输出支持
本地化支持
并发支持 (C11)
技术规范
符号索引

常用数学函数
浮点环境 (C99)
伪随机数生成
复数算术 (C99)
泛型数学函数 (C99)

powpowfpowl (C99)(C99)	计算一个数的给定次幂（\(\small{x^y}\) $x y$ ） (函数)
sqrtsqrtfsqrtl (C99)(C99)	计算平方根（\(\small{\sqrt{x} }\) $\sqrt x$ ） (函数)
hypothypotfhypotl (C99)(C99)(C99)	计算两个给定数平方和的平方根（\(\scriptsize{\sqrt{x^2+y^2} }\) $\sqrt x 2 +y 2$ ） (函数)

cbrt, cbrtf, cbrtl

参数

返回值

错误处理

注解

示例

引用

参阅

导航