命名空间
变体
操作

cbrt、cbrtf、cbrtl

来自 cppreference.com
< c‎ | numeric‎ | math
 
 
 
常用数学函数
类型
(C99)(C99)    

(C99)(C99)    

函数
基本运算
(C99)
(C99)
(C99)
(C99)(C99)(C99)(C23)
最大值/最小值运算
(C99)
(C23)    
指数函数
(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)
(C99)
(C99)(C99)(C99)
(C23)(C23)(C23)(C23)
浮点操作函数
(C99)(C99)
(C99)(C23)
(C99)
缩窄运算
(C23)
(C23)
(C23)
(C23)
(C23)
(C23)
量子和量子指数函数
十进制重新编码函数
全序和有效载荷函数
分类
(C99)
(C99)
(C99)
(C23)
宏常量
特殊浮点值
(C99)(C23)
参数和返回值
(C99)(C99)(C99)(C99)(C99)    
错误处理
(C99)    

 
在头文件 <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)
(函数) [编辑]
(C99)(C99)
计算平方根 (x)
(函数) [编辑]
(C99)(C99)(C99)
计算两个给定数字的平方和的平方根 (x2
+y2
)
(函数) [编辑]
C++ 文档 for cbrt