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

出自cppreference.com
< cpp‎ | numeric‎ | math
 
C++
 
數值庫
 
常用數學函數
函數
基礎運算
(C++11)  
(C++11)
(C++11)
(C++11)
(C++11)
(C++11)
(C++11)(C++11)(C++11)
指數函數
(C++11)
(C++11)

(C++11)
(C++11)
冪函數
(C++11)
(C++11)
三角與雙曲函數
(C++11)
(C++11)
(C++11)

誤差與伽馬函數
(C++11)
(C++11)
(C++11)
(C++11)
浮點數的最接近整數
(C++11)(C++11)(C++11)
(C++11)
(C++11)
rintlrintllrint
(C++11)(C++11)(C++11)
浮點數操作函數
(C++11)(C++11)
(C++11)
(C++11)
(C++11)(C++11)
(C++11)
分類與比較
(C++11)
(C++11)
(C++11)
(C++11)
(C++11)
(C++11)
(C++11)
(C++11)
(C++11)
(C++11)
(C++11)
(C++11)
類型
(C++11)
(C++11)
(C++11)
宏常量
分類
(C++11)(C++11)(C++11)(C++11)(C++11)


 
在標頭 <cmath> 定義
舍入到浮點數類型
(1)
float       rint ( float num );

double      rint ( double num );

long double rint ( long double num );
 (C++11 起)
(C++23 前)
/* floating-point-type */ rint( /* floating-point-type */ num );
 (C++23 起)
float       rintf( float num );
 (2) (C++11 起)
long double rintl( long double num );
 (3) (C++11 起)
舍入到 long
(4)
long lrint ( float num );

long lrint ( double num );

long lrint ( long double num );
 (C++11 起)
(C++23 前)
long lrint ( /* floating-point-type */ num );
 (C++23 起)
long lrintf( float num );
 (5) (C++11 起)
long lrintl( long double num );
 (6) (C++11 起)
舍入到 long long
(7)
long long llrint ( float num );

long long llrint ( double num );

long long llrint ( long double num );
 (C++11 起)
(C++23 前)
long long llrint ( /* floating-point-type */ num );
 (C++23 起)
long long llrintf( float num );
 (8) (C++11 起)
long long llrintl( long double num );
 (9) (C++11 起)
在標頭 <cmath> 定義
template< class Integer >
double rint( Integer num );
 (A) (C++11 起)
template< class Integer >
long lrint( Integer num );
 (B) (C++11 起)
template< class Integer >
long long llrint( Integer num );
 (C) (C++11 起)
1-3) 用當前舍入模式，舍入浮點數實參 num 為（浮點數格式的）整數。標準庫提供所有以無 cv 限定的浮點數類型作為實參 num 的類型的 std::rint 重載。(C++23 起)
4-9) 用當前舍入模式，舍入浮點數實參 num 為整數。標準庫提供所有以無 cv 限定的浮點數類型作為實參 num 的類型的 std::lrint 和 std::llrint 重載。(C++23 起)
A-C) 為所有整數類型提供額外重載，將它們當做 double。

目錄

[編輯] 參數

num - 浮點數或整數

[編輯] 返回值

如果沒有發生錯誤，那麼返回 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）。

如果當前舍入模式是：

額外重載不需要以 (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::feclearexcept(FE_ALL_EXCEPT);
 
    std::cout << "std::lrint(LONG_MIN-2048.0) = "
              << std::lrint(LONG_MIN - 2048.0) << '\n';
    if (std::fetestexcept(FE_INVALID))
        std::cout << "    发生 FE_INVALID\n";
}

可能的輸出： 

就近舍入（在中点舍入到偶数）：
  rint(+2.3) = 2
  rint(+2.5) = 2
  rint(+3.5) = 4
  rint(-2.3) = -2
  rint(-2.5) = -2
  rint(-3.5) = -4
向下舍入：
  rint(+2.3) = 2
  rint(+2.5) = 2
  rint(+3.5) = 4
  rint(-2.3) = -2
  rint(-2.5) = -2
  rint(-3.5) = -4
使用 lrint 向下舍入：
  lrint(+2.3) = 2
  lrint(+2.5) = 2
  lrint(+3.5) = 3
  lrint(-2.3) = -3
  lrint(-2.5) = -3
  lrint(-3.5) = -4
特殊值：
  lrint(-0.0) = 0
  lrint(-Inf) = 0x8000000000000000
std::rint(0.1) = 0
std::lrint(LONG_MIN-2048.0) = 0x8000000000000000
    发生 FE_INVALID

[編輯] 參閱

(C++11)(C++11)(C++11)
 絕對值不大於給定值的最接近整數
(函數) [編輯]
(C++11)(C++11)(C++11)
 使用當前舍入模式的最接近整數
(函數) [編輯]
(C++11)(C++11)
 獲取或設置舍入方向
(函數) [編輯]
rint 的 C 文檔
取自「https://zh.cppreference.com/mwiki/index.php?title=cpp/numeric/math/rint&oldid=95779」