命名空间
变体
操作

cbrt, cbrtf, cbrtl

来自 cppreference.cn
< c‎ | 数值‎ | 数学
 
 
 
常用数学函数
函数
基本操作
(C99)
(C99)
(C99)
(C99)(C99)(C99)(C23)
最大值/最小值操作
(C99)
(C99)
指数函数
(C23)
(C99)
(C99)
(C23)
(C23)

(C99)
(C99)(C23)
(C23)
(C23)
幂函数
cbrt
(C99)
(C23)
(C23)

(C99)
(C23)
(C23)
三角函数和双曲函数
(C23)
(C23)
(C23)
(C23)
(C99)
(C99)
(C99)
最近整数浮点数
(C99)(C99)(C99)
(C99)

(C99)(C99)(C99)
(C23)(C23)(C23)(C23)
浮点数操作
(C99)(C99)
(C99)(C23)
(C99)
窄化操作
(C23)
(C23)
(C23)
(C23)
(C23)
(C23)
量子与量子指数
十进制重新编码函数
总序和载荷函数
分类
(C99)
(C99)
(C99)
(C23)
误差函数和伽马函数
(C99)
(C99)
(C99)
(C99)
类型
宏常量
特殊浮点值
(C99)(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 的立方根(3arg)。

如果因下溢发生范围错误,则返回正确结果(舍入后)。

[编辑] 错误处理

错误报告按照 math_errhandling 中指定的方式。

如果实现支持 IEEE 浮点运算 (IEC 60559),

  • 如果参数是 ±0 或 ±∞,则原样返回。
  • 如果参数为 NaN,则返回 NaN。

[编辑] 注意

cbrt(arg) 不等同于 pow(arg, 1.0/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 cbrt 函数 (p: TBD)
  • 7.25 类型通用数学 <tgmath.h> (p: TBD)
  • F.10.4.1 cbrt 函数 (p: TBD)
  • C17 标准 (ISO/IEC 9899:2018)
  • 7.12.7.1 cbrt 函数 (p: 180-181)
  • 7.25 类型通用数学 <tgmath.h> (p: 272-273)
  • F.10.4.1 cbrt 函数 (p: 381-)
  • C11 标准 (ISO/IEC 9899:2011)
  • 7.12.7.1 cbrt 函数 (p: 247)
  • 7.25 类型通用数学 <tgmath.h> (p: 373-375)
  • F.10.4.1 cbrt 函数 (p: 524)
  • C99 标准 (ISO/IEC 9899:1999)
  • 7.12.7.1 cbrt 函数 (p: 228)
  • 7.22 类型通用数学 <tgmath.h> (p: 335-337)
  • F.9.4.1 cbrt 函数 (p: 460)

[编辑] 另请参阅

(C99)(C99)
计算给定幂的数字 (xy)
(function) [编辑]
(C99)(C99)
计算平方根 (x)
(function) [编辑]
(C99)(C99)(C99)
计算两个给定数的平方和的平方根(x2
+y2

(function) [编辑]
C++ 文档,关于 cbrt