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)

十进制重新编码函数

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)

[编辑]

定义于头文件

float cbrtf( float arg );

(1)

(C99 起)

double cbrt( double arg );

(2)

(C99 起)

long double cbrtl( long double arg );

(3)

(C99 起)

定义于头文件

#define cbrt( arg )

(4)

(C99 起)

1-3) 计算 arg 的立方根。

4) 类型通用宏：如果 arg 的类型是 long double，则调用 cbrtl。否则，如果 arg 的类型是整数类型或 double，则调用 cbrt。否则，调用 cbrtf。

目录

1 参数

2 返回值

3 错误处理

4 注意

5 示例

6 引用

7 参阅

[编辑] 参数

arg

-

浮点值

[编辑] 返回值

如果没有错误发生，返回 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} }\)13 通常不等于 1.0/3，并且 std::pow 不能将负数作为底数，分数作为指数。此外，cbrt(arg) 通常比 pow(arg, 1.0/3) 提供更精确的结果（参见示例）。[编辑] 示例

运行此代码

#include

#include

#include

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 cbrt 函数 (p: TBD)

7.25 类型通用数学 (p: TBD)

F.10.4.1 cbrt 函数 (p: TBD)

C17 标准 (ISO/IEC 9899:2018)

7.12.7.1 cbrt 函数 (p: 180-181)

7.25 类型通用数学 (p: 272-273)

F.10.4.1 cbrt 函数 (p: 381-)

C11 标准 (ISO/IEC 9899:2011)

7.12.7.1 cbrt 函数 (p: 247)

7.25 类型通用数学 (p: 373-375)

F.10.4.1 cbrt 函数 (p: 524)

C99 标准 (ISO/IEC 9899:1999)

7.12.7.1 cbrt 函数 (p: 228)

7.22 类型通用数学 (p: 335-337)

F.9.4.1 cbrt 函数 (p: 460)

[编辑] 另请参阅

powpowfpowl(C99)(C99)

计算给定幂的数字 (\(\small{x^y}\)xy) (function) [编辑]

sqrtsqrtfsqrtl(C99)(C99)

计算平方根 (\(\small{\sqrt{x} }\)√x) (function) [编辑]

hypothypotfhypotl(C99)(C99)(C99)

计算两个给定数的平方和的平方根（\(\scriptsize{\sqrt{x^2+y^2} }\)√x2+y2） (function) [编辑]

C++ 文档，关于 cbrt