std::round, std::roundf, std::roundl, std::lround, std::lroundf, std::lroundl, std::llround, std::llroundf

定義於標頭檔案 `<cmath>`
舍入到浮點型別
	(1)
float round ( float num ); double round ( double num ); long double round ( long double num );			(C++11 起) (直至 C++23)
constexpr /* 浮點型別 / round ( / 浮點型別 */ num );			(C++23 起)
float roundf( float num );		(2)	(C++11 起) (C++23 起為 constexpr)
long double roundl( long double num );		(3)	(C++11 起) (C++23 起為 constexpr)
舍入到 long
		(4)
long lround ( float num ); long lround ( double num ); long lround ( long double num );				(C++11 起) (直至 C++23)
constexpr long lround( /* 浮點型別 */ num );				(C++23 起)
long lroundf( float num );			(5)	(C++11 起) (C++23 起為 constexpr)
long lroundl( long double num );			(6)	(C++11 起) (C++23 起為 constexpr)
舍入到 long long
			(7)
long long llround ( float num ); long long llround ( double num ); long long llround ( long double num );					(C++11 起) (直至 C++23)
constexpr long long llround( /* 浮點型別 */ num );					(C++23 起)
long long llroundf( float num );				(8)	(C++11 起) (C++23 起為 constexpr)
long long llroundl( long double num );				(9)	(C++11 起) (C++23 起為 constexpr)
附加過載
定義於標頭檔案 `<cmath>`
template< class Integer > double round( Integer num );				(A)	(C++11 起) (C++23 起為 constexpr)
template< class Integer > long lround( Integer num );				(B)	(C++11 起) (C++23 起為 constexpr)
template< class Integer > long long llround( Integer num );				(C)	(C++11 起) (C++23 起為 constexpr)

1-3) 計算最接近 num 的整數值（浮點格式），半值遠離零舍入，而無論當前舍入模式如何。庫為所有 cv-不限定浮點型別提供了 std::round 的過載作為引數 num 的型別。(C++23 起)

4-9) 計算最接近 num 的整數值（整數格式），半值遠離零舍入，而無論當前舍入模式如何。庫為所有 cv-不限定浮點型別提供了 std::lround 和 std::llround 的過載作為引數 num 的型別。(C++23 起)

A-C) 為所有整數型別提供額外過載，它們被當作 double 處理。

#include <cfenv>
#include <cmath>
 
#pragma STDC FENV_ACCESS ON
 
double round(double x)
{
    const int save_round = std::fegetround();
    std::fesetround(FE_TOWARDZERO);
    const double result = std::rint(std::copysign(0.5 + std::fabs(x), x));
    std::fesetround(save_round);
    return result;
}

額外過載無需完全按照 (A-C) 提供。它們只需足以確保對於其整數型別的引數 num

std::round(num) 具有與 std::round(static_cast<double>(num)) 相同的效果。
std::lround(num) 具有與 std::lround(static_cast<double>(num)) 相同的效果。
std::llround(num) 具有與 std::llround(static_cast<double>(num)) 相同的效果。

[編輯] 示例

執行此程式碼

#include <cassert>
#include <cfenv>
#include <cfloat>
#include <climits>
#include <cmath>
#include <iostream>
 
// #pragma STDC FENV_ACCESS ON
 
double custom_round(double x)
{
    const int save_round = std::fegetround();
    std::fesetround(FE_TOWARDZERO);
    const double result = std::rint(std::copysign(0.5 + std::fabs(x), x));
    std::fesetround(save_round);
    return result;
}
 
void test_custom_round()
{
    for (const double x :
        {
            0.0, 0.3,
            0.5 - DBL_EPSILON / 2,
            0.5,
            0.5 + DBL_EPSILON / 2,
            0.7, 1.0, 2.3, 2.5, 2.7, 3.0,
            static_cast<double>(INFINITY)
        })
        assert(round(+x) == custom_round(+x) && round(-x) == custom_round(-x));
}
 
int main()
{
    test_custom_round();
 
    std::cout << std::showpos;
 
    // round
    std::cout << "round(+2.3) = " << std::round(2.3)
              << "  round(+2.5) = " << std::round(2.5)
              << "  round(+2.7) = " << std::round(2.7) << '\n'
              << "round(-2.3) = " << std::round(-2.3)
              << "  round(-2.5) = " << std::round(-2.5)
              << "  round(-2.7) = " << std::round(-2.7) << '\n';
 
    std::cout << "round(-0.0) = " << std::round(-0.0)  << '\n'
              << "round(-Inf) = " << std::round(-INFINITY) << '\n';
 
    // lround
    std::cout << "lround(+2.3) = " << std::lround(2.3)
              << "  lround(+2.5) = " << std::lround(2.5)
              << "  lround(+2.7) = " << std::lround(2.7) << '\n'
              << "lround(-2.3) = " << std::lround(-2.3)
              << "  lround(-2.5) = " << std::lround(-2.5)
              << "  lround(-2.7) = " << std::lround(-2.7) << '\n';
 
    std::cout << "lround(-0.0) = " << std::lround(-0.0)  << '\n'
              << "lround(-Inf) = " << std::lround(-INFINITY) << '\n';
 
    // error handling
    std::feclearexcept(FE_ALL_EXCEPT);
 
    std::cout << "std::lround(LONG_MAX+1.5) = "
              << std::lround(LONG_MAX + 1.5) << '\n';
    if (std::fetestexcept(FE_INVALID))
        std::cout << "    FE_INVALID was raised\n";
}

可能的輸出

round(+2.3) = +2  round(+2.5) = +3  round(+2.7) = +3
round(-2.3) = -2  round(-2.5) = -3  round(-2.7) = -3
round(-0.0) = -0
round(-Inf) = -inf
lround(+2.3) = +2  lround(+2.5) = +3  lround(+2.7) = +3
lround(-2.3) = -2  lround(-2.5) = -3  lround(-2.7) = -3
lround(-0.0) = +0
lround(-Inf) = -9223372036854775808
std::lround(LONG_MAX+1.5) = -9223372036854775808
    FE_INVALID was raised

[編輯] 參閱

floorfloorffloorl (C++11)(C++11)	不大於給定值的最接近整數 (函式) [編輯]
ceilceilfceill (C++11)(C++11)	不小於給定值的最接近整數 (函式) [編輯]
trunctruncftruncl (C++11)(C++11)(C++11)	不大於給定值幅度的最接近整數 (函式) [編輯]
C 文件關於 round

編譯器支援
自由（freestanding）與宿主（hosted）
語言
標準庫
標準庫標頭檔案
具名要求
特性測試宏 (C++20)
語言支援庫
概念庫 (C++20)
診斷庫
記憶體管理庫
超程式設計庫 (C++11)
通用工具庫
容器庫
迭代器庫
範圍庫 (C++20)
演算法庫
字串庫
文字處理庫
數值庫
日期和時間庫
輸入/輸出庫
檔案系統庫 (C++17)
併發支援庫 (C++11)
執行控制庫 (C++26)
技術規範
符號索引
外部庫

cppreference.com

名稱空間

變體

檢視

操作

std::round, std::roundf, std::roundl, std::lround, std::lroundf, std::lroundl, std::llround, std::llroundf

目錄

[編輯] 引數

[編輯] 返回值

[編輯] 錯誤處理

[編輯] 註釋

[編輯] 示例

[編輯] 參閱

導航

工具箱