std:: rint, std:: rintf, std:: rintl, std:: lrint, std:: lrintf, std:: lrintl, std:: llrint, std:: llrintf

参数

返回值

如果未发生错误，则根据 当前舍入模式 返回最接近 num 的整数值。

错误处理

错误报告方式遵循 math_errhandling 中的规范。

如果 std::lrint 或 std::llrint 的结果超出返回类型可表示的范围，则可能出现域错误或范围错误。

若实现支持 IEEE 浮点算术（IEC 60559），

对于 std::rint 函数：

• 如果 num 为 ±∞，则直接返回原值。
• 如果 num 为 ±0，则直接返回原值。
• 如果 num 为 NaN，则返回 NaN。

对于 std::lrint 和 std::llrint 函数：

• 如果 num 为 ±∞，将引发 FE_INVALID 并返回实现定义的值。
• 如果舍入结果超出返回类型的范围，将引发 FE_INVALID 并返回实现定义的值。
• 如果 num 为 NaN，将引发 FE_INVALID 并返回实现定义的值。

注释

POSIX 标准规定 ，所有导致 std::lrint 或 std::llrint 引发 FE_INEXACT 的情况均属于定义域错误。

如 math_errhandling 所规定，当对非整数有限值进行舍入时， std::rint 可能（但在非IEEE浮点数平台上不强制要求）引发 FE_INEXACT 。

std::rint 与 std::nearbyint 的唯一区别在于 std::nearbyint 永远不会引发 FE_INEXACT 。

在所有标准浮点格式中，最大可表示的浮点值都是精确整数，因此 std::rint 自身永远不会溢出；然而当结果存入整型变量时，可能溢出任何整数类型（包括 std::intmax_t ）。

如果当前舍入模式为：

• 若当前舍入模式为 FE_DOWNWARD ，则 std::rint 等效于 std::floor 。
• 若当前舍入模式为 FE_UPWARD ，则 std::rint 等效于 std::ceil 。
• 若当前舍入模式为 FE_TOWARDZERO ，则 std::rint 等效于 std::trunc 。
• 若当前舍入模式为 FE_TONEAREST ，则 std::rint 与 std::round 的区别在于：中间值会向最近的偶数舍入，而非远离零的方向舍入。

额外的重载不需要完全按照 (A-C) 的形式提供。它们只需确保对于整数类型的参数 num 能够满足：

• std :: rint ( num ) 具有与 std :: rint ( static_cast < double > ( num ) ) 相同的效果。
• std :: lrint ( num ) 具有与 std :: lrint ( static_cast < double > ( num ) ) 相同的效果。
• std :: llrint ( num ) 具有与 std :: llrint ( static_cast < double > ( num ) ) 相同的效果。

示例

#include <cfenv>
#include <climits>
#include <cmath>
#include <iostream>
// #pragma STDC FENV_ACCESS ON
int main()
{
    std::fesetround(FE_TONEAREST);
    std::cout << "向最近取整（中间值向偶数取整）：\n"
              << "  rint(+2.3) = " << std::rint(2.3) << '\n'
              << "  rint(+2.5) = " << std::rint(2.5) << '\n'
              << "  rint(+3.5) = " << std::rint(3.5) << '\n'
              << "  rint(-2.3) = " << std::rint(-2.3) << '\n'
              << "  rint(-2.5) = " << std::rint(-2.5) << '\n'
              << "  rint(-3.5) = " << std::rint(-3.5) << '\n';
    std::fesetround(FE_DOWNWARD);
    std::cout << "向下取整：\n"
              << "  rint(+2.3) = " << std::rint(2.3) << '\n'
              << "  rint(+2.5) = " << std::rint(2.5) << '\n'
              << "  rint(+3.5) = " << std::rint(3.5) << '\n'
              << "  rint(-2.3) = " << std::rint(-2.3) << '\n'
              << "  rint(-2.5) = " << std::rint(-2.5) << '\n'
              << "  rint(-3.5) = " << std::rint(-3.5) << '\n'
              << "使用 lrint 向下取整：\n"
              << "  lrint(+2.3) = " << std::lrint(2.3) << '\n'
              << "  lrint(+2.5) = " << std::lrint(2.5) << '\n'
              << "  lrint(+3.5) = " << std::lrint(3.5) << '\n'
              << "  lrint(-2.3) = " << std::lrint(-2.3) << '\n'
              << "  lrint(-2.5) = " << std::lrint(-2.5) << '\n'
              << "  lrint(-3.5) = " << std::lrint(-3.5) << '\n'
              << "特殊值：\n"
              << "  lrint(-0.0) = " << std::lrint(-0.0) << '\n'
              << std::hex << std::showbase
              << "  lrint(-Inf) = " << std::lrint(-INFINITY) << '\n';
    // 错误处理
    std::feclearexcept(FE_ALL_EXCEPT);
    std::cout << "std::rint(0.1) = " << std::rint(.1) << '\n';
    if (std::fetestexcept(FE_INEXACT))
        std::cout << "  触发了 FE_INEXACT\n";
    std::<

参见