命名空间
变体
操作

cbrt, cbrtf, cbrtl

来自 cppreference.cn
< c‎ | numeric‎ | math
 
 
 
常用数学函数
函数
基本运算
(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 函数 (页码:待定)
  • 7.25 类型泛型数学 <tgmath.h> (页码:待定)
  • F.10.4.1 cbrt 函数 (页码:待定)
  • C17 标准 (ISO/IEC 9899:2018)
  • 7.12.7.1 cbrt 函数 (页码:180-181)
  • 7.25 类型泛型数学 <tgmath.h> (页码:272-273)
  • F.10.4.1 cbrt 函数 (页码:381-)
  • C11 标准 (ISO/IEC 9899:2011)
  • 7.12.7.1 cbrt 函数 (页码:247)
  • 7.25 类型泛型数学 <tgmath.h> (页码:373-375)
  • F.10.4.1 cbrt 函数 (页码:524)
  • C99 标准 (ISO/IEC 9899:1999)
  • 7.12.7.1 cbrt 函数 (页码:228)
  • 7.22 类型泛型数学 <tgmath.h> (页码:335-337)
  • F.9.4.1 cbrt 函数 (页码:460)

[编辑] 参见

(C99)(C99)
计算给定数字的给定次幂 (xy)
(函数) [编辑]
(C99)(C99)
计算平方根 (x)
(函数) [编辑]
(C99)(C99)(C99)
计算两个给定数字的平方和的平方根 (x2
+y2
)
(函数) [编辑]
C++ 文档 关于 cbrt