浮點環境 (自 C++11 起)

 

C++

編譯器支援

獨立式與託管式

語言

標準函式庫

標準函式庫標頭檔

具名要求

特性測試巨集 (C++20)

語言支援函式庫

概念函式庫 (C++20)

診斷函式庫

記憶體管理函式庫

元編程函式庫 (C++11)

通用公用程式函式庫

容器函式庫

疊代器函式庫

Ranges 函式庫 (C++20)

演算法函式庫

字串函式庫

文本處理函式庫

數值函式庫

日期與時間函式庫

輸入/輸出函式庫

檔案系統函式庫 (C++17)

並行支援函式庫 (C++11)

執行控制函式庫 (C++26)

技術規範

符號索引

外部函式庫

 

數值函式庫

常用數學函式
特殊數學函式 (C++17)
數學常數 (C++20)
基本線性代數演算法 (C++26)
資料平行型別 (SIMD) (C++26)
浮點環境 (C++11)
複數
數值陣列 (valarray)
偽隨機數生成
位元操作 (C++20)
因數分解運算
最大公因數 (C++17)	最小公倍數 (C++17)
內插
中點 (C++20)	lerp (C++20)
飽和運算
add_sat (C++26) sub_sat (C++26) saturate_cast (C++26)	mul_sat (C++26) div_sat (C++26)
通用數值運算
iota (C++11) ranges::iota (C++23) accumulate inner_product adjacent_difference    partial_sum	reduce (C++17) transform_reduce (C++17) inclusive_scan (C++17) exclusive_scan (C++17) transform_inclusive_scan (C++17) transform_exclusive_scan (C++17)

 

浮點環境

函式

feclearexcept (C++11)

fetestexcept (C++11)

feraiseexcept (C++11)

fegetexceptflagfesetexceptflag (C++11)(C++11)

fegetroundfesetround (C++11)(C++11)

fegetenvfesetenv (C++11)(C++11)

feholdexcept (C++11)

feupdateenv (C++11)

巨集常數

FE_ALL_EXCEPTFE_DIVBYZEROFE_INEXACTFE_INVALIDFE_OVERFLOWFE_UNDERFLOW (C++11)(C++11)(C++11)(C++11)(C++11)(C++11)

FE_DOWNWARDFE_TONEARESTFE_TOWARDZEROFE_UPWARD (C++11)(C++11)(C++11)(C++11)

FE_DFL_ENV (C++11)

 

浮點環境是實作所支援的浮點狀態旗標與控制模式的集合。它是執行緒區域的（thread-local）。每個執行緒皆會從父執行緒繼承其浮點環境的初始狀態。浮點運算會修改浮點狀態旗標，以指示異常結果或輔助資訊。浮點控制模式的狀態會影響某些浮點運算的結果。

浮點環境的存取與修改僅在支援 #pragma STDC FENV_ACCESS 且將其設定為 ON 時才有意義。否則，實作可以自由假定浮點控制模式始終為預設值，且浮點狀態旗標永遠不會被測試或修改。實際上，極少數目前的編譯器（例如 HP aCC、Oracle Studio 或 IBM XL）會明確支援此 #pragma，但大多數編譯器無論如何都允許對浮點環境進行有意義的存取。

類型

定義於標頭 <cfenv>
fenv_t (C++11)	表示整個浮點環境的類型 (typedef)
fexcept_t (C++11)	集體表示所有浮點狀態旗標的類型 (typedef)

函式

feclearexcept (C++11)	清除指定的浮點狀態旗標 (函式)
fetestexcept (C++11)	判斷指定的浮點狀態旗標中哪一個被設定 (函式)
feraiseexcept (C++11)	引發指定的浮點異常 (函式)
fegetexceptflagfesetexceptflag (C++11)(C++11)	從浮點環境複製或將狀態複製到浮點環境的指定浮點狀態旗標 (函式)
fegetroundfesetround (C++11)(C++11)	取得或設定捨入方向 (函式)
fegetenvfesetenv (C++11)	儲存或還原當前的浮點環境 (函式)
feholdexcept (C++11)	儲存環境、清除所有狀態旗標並忽略所有未來錯誤 (函式)
feupdateenv (C++11)	還原浮點環境並引發先前引發的異常 (函式)

巨集

FE_ALL_EXCEPTFE_DIVBYZEROFE_INEXACTFE_INVALIDFE_OVERFLOWFE_UNDERFLOW (C++11)	浮點異常 (巨集常數)
FE_DOWNWARDFE_TONEARESTFE_TOWARDZEROFE_UPWARD (C++11)	浮點捨入方向 (巨集常數)
FE_DFL_ENV (C++11)	預設浮點環境 (巨集常數)

附註

浮點異常與 C++ 異常無關。當浮點運算引發浮點異常時，浮點環境的狀態會改變，這可以透過 std::fetestexcept 進行測試，但在大多數實作中，C++ 程式的執行會持續進行而不中斷。

有一些編譯器擴充功能可用於在每次引發浮點異常時自動產生 C++ 異常。

• GNU libc 函式 feenableexcept() 可啟用浮點異常的捕捉，這會產生 SIGFPE 訊號。如果使用了編譯器選項 -fnon-call-exceptions，則該訊號的處理常式可能會拋出使用者自定義的 C++ 異常。
• MSVC 函式 _control87() 可啟用浮點異常的捕捉，這會產生硬體異常，並可透過 _set_se_translator 轉換為 C++ 異常。

參閱

C 文件 關於 浮點環境