C++ 参考手册
- C++11
- C++14
- C++17
- C++20
- C++ 编译器支持情况表
- 独立与宿主实现
- C++ 语言
- C++ 关键词
- 预处理器
- C++ 标准库头文件
- 具名要求
- 功能特性测试 (C++20)
- 工具库
- 类型支持(基本类型、RTTI、类型特性)
- 概念库 (C++20)
- 错误处理
- 动态内存管理
- 日期和时间工具
- 字符串库
- 容器库
- 迭代器库
- 范围库 (C++20)
- 算法库
- 数值库
- 常用数学函数
- std::abs(int), std::labs, std::llabs, std::imaxabs
- std::div, std::ldiv, std::lldiv
- std::fmod, std::fmodf, std::fmodl
- std::remainder, std::remainderf, std::remainderl
- std::remquo, std::remquof, std::remquol
- std::hypot, std::hypotf, std::hypotl
- std::abs(float), std::fabs, std::fabsf, std::fabsl
- std::sqrt, std::sqrtf, std::sqrtl
- std::sin, std::sinf, std::sinl
- std::fma, std::fmaf, std::fmal
- std::fmax, std::fmaxf, std::fmaxl
- std::fmin, std::fminf, std::fminl
- std::fdim, std::fdimf, std::fdiml
- NAN
- std::exp, std::expf, std::expl
- std::exp2, std::exp2f, std::exp2l
- std::expm1, std::expm1f, std::expm1l
- std::log, std::logf, std::logl
- std::log10, std::log10f, std::log10l
- std::log1p, std::log1pf, std::log1pl
- std::log2, std::log2f, std::log2l
- std::cbrt, std::cbrtf, std::cbrtl
- std::pow, std::powf, std::powl
- std::cos, std::cosf, std::cosl
- std::tan, std::tanf, std::tanl
- std::asin, std::asinf, std::asinl
- std::acos, std::acosf, std::acosl
- std::atan, std::atanf, std::atanl
- std::atan2, std::atan2f, std::atan2l
- std::sinh, std::sinhf, std::sinhl
- std::cosh, std::coshf, std::coshl
- std::tanh, std::tanhf, std::tanhl
- std::asinh, std::asinhf, std::asinhl
- std::acosh, std::acoshf, std::acoshl
- std::atanh, std::atanh, std::atanhl
- std::erf, std::erff, std::erfl
- std::erfc, std::erfcf, std::erfcl
- std::lgamma, std::lgammaf, std::lgammal
- std::tgamma, std::tgammaf, std::tgammal
- std::ceil, std::ceilf, std::ceill
- std::floor, std::floorf, std::floorl
- std::round, std::roundf, std::roundl, std::lround, std::lroundf, std::lroundl, std::llround, std::llroundf
- std::trunc, std::truncf, std::truncl
- std::nearbyint, std::nearbyintf, std::nearbyintl
- std::rint, std::rintf, std::rintl, std::lrint, std::lrintf, std::lrintl, std::llrint, std::llrintf
- std::ldexp, std::ldexpf, std::ldexpl
- std::scalbn, std::scalbnf, std::scalbnl, std::scalbln, std::scalblnf, std::scalblnl
- std::ilogb, std::ilogbf, std::ilogbl
- std::logb, std::logbf, std::logbl
- std::frexp, std::frexpf, std::frexpl
- std::modf, std::modff, std::modfl
- std::nextafter, std::nextafterf, std::nextafterl, std::nexttoward, std::nexttowardf, std::nexttowardl
- std::copysign, std::copysignf, std::copysignl
- std::fpclassify
- std::isfinite
- std::isinf
- std::isnan
- std::isnormal
- std::signbit
- std::isgreater
- std::isgreaterequal
- std::isless
- std::islessequal
- std::islessgreater
- std::isunordered
- HUGE_VALF, HUGE_VAL, HUGE_VALL
- INFINITY
- MATH_ERRNO, MATH_ERREXCEPT, math_errhandling
- FP_NORMAL, FP_SUBNORMAL, FP_ZERO, FP_INFINITE, FP_NAN
- std::midpoint
- std::lerp
- std::has_single_bit
- std::bit_ceil
- std::bit_floor
- std::bit_width
- std::rotl
- 数学特殊函数
- 伪随机数生成
- 浮点环境
- std::complex
- std::valarray
- 编译时有理数算术
- std::gcd
- std::lcm
- 数学常数
- std::bit_cast
- std::rotr
- std::countl_zero
- std::countl_one
- std::countr_zero
- std::countr_one
- std::popcount
- 注释
- 输入/输出库
- 文件系统库
- 本地化库
- 正则表达式库
- 原子操作库
- 线程支持库
- 实验性 C++ 特性
- 有用的资源
- 索引
- std 符号索引
- 协程支持 (C++20)
- C++ 关键词
MATH_ERRNO, MATH_ERREXCEPT, math_errhandling
定义于头文件 <cmath>
|
||
#define MATH_ERRNO 1 |
(C++11 起) | |
#define MATH_ERREXCEPT 2 |
(C++11 起) | |
#define math_errhandling /*implementation defined*/ |
(C++11 起) | |
宏常量 math_errhandling
展开成 int 类型的表达式,要么等于 MATH_ERRNO
,要么等于 MATH_ERREXCEPT
,要么等于其逐位或( MATH_ERRNO | MATH_ERREXCEPT )。
math_errhandling
的值指示浮点运算符和函数所进行的错误处理:
常量 | 解释 |
MATH_ERREXCEPT
|
指示使用浮点异常: <cfenv> 中至少定义了 FE_DIVBYZERO 、 FE_INVALID 及 FE_OVERFLOW 。 |
MATH_ERRNO
|
指明浮点运算使用变量 errno 报告错误。 |
若实现支持 IEEE 浮点算术( IEC 60559 ),则要求 math_errhandling & MATH_ERREXCEPT 非零。
识别下列浮点错误条件:
条件 | 解释 | errno | 浮点异常 | 示例 |
---|---|---|---|---|
定义域错误 | 参数在该运算的数学上的定义域之外(每个函数的描述列出了要求的定义域错误) | EDOM | FE_INVALID | std::acos(2) |
极点错误 | 函数的数学结果恰是无限大或未定义 | ERANGE | FE_DIVBYZERO | std::log(0.0) 、 1.0/0.0 |
上溢所致的值域错误 | 数学结果有限,但舍入后变为无限,或在向下舍入后变成最大可表示有限值 | ERANGE | FE_OVERFLOW | std::pow(DBL_MAX,2) |
下溢所致的域错误 | 结果非零,但因为舍入变为零,或变成非正规并有精度损失 | ERANGE 或不改变(实现定义) | FE_UNDERFLOW 或无(实现定义) | DBL_TRUE_MIN/2 |
结果不准确 | 结果必须被舍入到目标类型 | 不改变 | FE_INEXACT 或无(未指定) | std::sqrt(2)、 1.0/10.0 |
注意
通常, FE_INEXACT 是否为数学库函数所引发是未指定的,但这可以显式指定于函数的描述(例如 std::rint vs std::nearbyint )。
C++11 前,浮点异常是未指定的,要求对于任何定义于错误有 EDOM ,要求对上溢和实现定义的下溢有 ERANGE 。
示例
运行此代码
#include <iostream> #include <cfenv> #include <cmath> #include <cerrno> #include <cstring> #pragma STDC FENV_ACCESS ON int main() { std::cout << "MATH_ERRNO is " << (math_errhandling & MATH_ERRNO ? "set" : "not set") << '\n' << "MATH_ERREXCEPT is " << (math_errhandling & MATH_ERREXCEPT ? "set" : "not set") << '\n'; std::feclearexcept(FE_ALL_EXCEPT); errno = 0; std::cout << "log(0) = " << std::log(0) << '\n'; if(errno == ERANGE) std::cout << "errno = ERANGE (" << std::strerror(errno) << ")\n"; if(std::fetestexcept(FE_DIVBYZERO)) std::cout << "FE_DIVBYZERO (pole error) reported\n"; }
可能的输出:
MATH_ERRNO is set MATH_ERREXCEPT is set log(0) = -inf errno = ERANGE (Numerical result out of range) FE_DIVBYZERO (pole error) reported
参阅
浮点异常 (宏常量) | |
展开成 POSIX 兼容的线程局域错误号变量的宏 (宏变量) |