fegetround, fesetround

 

C

編譯器支援

語言

標頭檔案

型別支援

程式工具

變參函式支援

錯誤處理

動態記憶體管理

字串庫

演算法

數值

日期和時間工具

輸入/輸出支援

本地化支援

併發支援 (C11)

技術規範

符號索引

 

數值

常用數學函式

浮點環境 (C99)

偽隨機數生成

複數運算 (C99)

型別通用數學 (C99)

位操作 (C23)

檢查整數運算 (C23)

 

浮點環境

函式

feclearexcept (C99)

fetestexcept (C99)

feraiseexcept (C99)

fegetexceptflagfesetexceptflag (C99)(C99)

fegetroundfesetround (C99)(C99)

fegetenvfesetenv (C99)

feholdexcept (C99)

feupdateenv (C99)

宏常量

FE_ALL_EXCEPTFE_DIVBYZEROFE_INEXACTFE_INVALIDFE_OVERFLOWFE_UNDERFLOW (C99)

FE_DOWNWARDFE_TONEARESTFE_TOWARDZEROFE_UPWARD (C99)

FE_DFL_ENV (C99)

 

定義於標頭檔案 <fenv.h>
int fesetround( int round );	(1)	(C99 起)
int fegetround();	(2)	(C99 起)

1) 嘗試將浮點舍入方向設定為引數 round，該引數預計是浮點舍入宏之一。

2) 返回與當前舍入方向對應的浮點舍入宏的值。

引數

round

-

舍入方向，是浮點舍入宏之一。

返回值

1) 成功時返回 ​0​，否則返回非零值。

2) 描述當前舍入方向的浮點舍入宏，如果無法確定方向則返回負值。

注意

當前舍入模式，反映最近 fesetround 的影響，也可以透過 FLT_ROUNDS 查詢。

示例

執行此程式碼

#include <fenv.h>
#include <math.h>
#include <stdio.h>
 
// #pragma STDC FENV_ACCESS ON
 
void show_fe_current_rounding_direction(void)
{
    printf("current rounding direction:  ");
    switch (fegetround())
    {
           case FE_TONEAREST:  printf ("FE_TONEAREST");  break;
           case FE_DOWNWARD:   printf ("FE_DOWNWARD");   break;
           case FE_UPWARD:     printf ("FE_UPWARD");     break;
           case FE_TOWARDZERO: printf ("FE_TOWARDZERO"); break;
           default:            printf ("unknown");
    };
    printf("\n");
}
 
int main(void)
{
    /* Default rounding direction */
    show_fe_current_rounding_direction();
    printf("+11.5 -> %+4.1f\n", rint(+11.5)); /* midway between two integers */
    printf("+12.5 -> %+4.1f\n", rint(+12.5)); /* midway between two integers */
 
    /* Save current rounding direction. */
    int curr_direction = fegetround();
 
    /* Temporarily change current rounding direction. */
    fesetround(FE_DOWNWARD);
    show_fe_current_rounding_direction();
    printf("+11.5 -> %+4.1f\n", rint(+11.5));
    printf("+12.5 -> %+4.1f\n", rint(+12.5));
 
    /* Restore default rounding direction. */
    fesetround(curr_direction);
    show_fe_current_rounding_direction();
 
    return 0;
}

可能的輸出

current rounding direction:  FE_TONEAREST
+11.5 -> +12.0
+12.5 -> +12.0
current rounding direction:  FE_DOWNWARD
+11.5 -> +11.0
+12.5 -> +12.0
current rounding direction:  FE_TONEAREST

參考

• C23 標準 (ISO/IEC 9899:2024)

• 7.6.3.1 fegetround 函式 (p: TBD)

• 7.6.3.2 fesetround 函式 (p: TBD)

• C17 標準 (ISO/IEC 9899:2018)

• 7.6.3.1 fegetround 函式 (p: TBD)

• 7.6.3.2 fesetround 函式 (p: TBD)

• C11 標準 (ISO/IEC 9899:2011)

• 7.6.3.1 fegetround 函式 (p: 212)

• 7.6.3.2 fesetround 函式 (p: 212-213)

• C99 標準 (ISO/IEC 9899:1999)

• 7.6.3.1 fegetround 函式 (p: 193)

• 7.6.3.2 fesetround 函式 (p: 193-194)

參閱

nearbyintnearbyintfnearbyintl (C99)(C99)(C99)	使用當前舍入模式四捨五入到整數 (函式)
rintrintfrintllrintlrintflrintlllrintllrintfllrintl (C99)(C99)(C99)(C99)(C99)(C99)(C99)(C99)(C99)	使用當前舍入模式四捨五入到整數 如果結果不同則丟擲異常 (函式)
C++ 文件 for fegetround, fesetround