浮點字面量

 

C++

編譯器支援

自由（freestanding）與宿主（hosted）

語言

標準庫

標準庫標頭檔案

具名要求

特性測試宏 (C++20)

語言支援庫

概念庫 (C++20)

診斷庫

記憶體管理庫

超程式設計庫 (C++11)

通用工具庫

容器庫

迭代器庫

範圍庫 (C++20)

演算法庫

字串庫

文字處理庫

數值庫

日期和時間庫

輸入/輸出庫

檔案系統庫 (C++17)

併發支援庫 (C++11)

執行控制庫 (C++26)

技術規範

符號索引

外部庫

 

C++ 語言

通用主題
預處理器 註釋	關鍵詞 轉義序列
流程控制
條件執行語句
if	switch
迭代語句（迴圈）
for range-for (C++11)	while do-while
跳轉語句
continue - break	goto - return
函式
函式宣告
Lambda 函式表示式
inline 說明符
動態異常規範 (直到 C++17*)
noexcept 說明符 (C++11)
異常
throw 表示式 try 塊	catch 處理程式
名稱空間
名稱空間宣告	命名空間別名
型別
基本型別 列舉型別 函式型別	類/結構體型別 聯合型別
說明符
const/volatile decltype (C++11) auto (C++11)	constexpr (C++11) consteval (C++20) constinit (C++20)
儲存期說明符
初始化
預設初始化 值初始化 零初始化 複製初始化 直接初始化	聚合初始化 列表初始化 (C++11)   常量初始化 引用初始化

表示式
值類別 求值順序	運算子 運算子優先順序
替代表示
字面量
布林 - 整型 - 浮點型
字元 - 字串 - nullptr (C++11)
使用者定義 (C++11)
工具
屬性 (C++11)
型別
typedef 宣告
類型別名宣告 (C++11)
型別轉換
隱式轉換 static_cast const_cast	顯式轉換 dynamic_cast reinterpret_cast
記憶體分配
new 表示式	delete 表示式
類
類宣告 建構函式 this 指標	訪問說明符 friend 說明符
類特有的函式屬性
虛擬函式 override 說明符 (C++11)   final 說明符 (C++11)	explicit (C++11) static
特殊成員函式
預設建構函式 複製建構函式 移動建構函式 (C++11)	複製賦值 移動賦值 (C++11) 解構函式
模板
類模板 函式模板	模板特化 引數包 (C++11)
雜項
內聯彙編	C++ 歷史

 

表示式

通用
值類別 求值順序 常量表達式 主表示式	Lambda 表示式 (C++11) Requires 表示式 (C++20) 包索引表示式 (C++26) 潛在求值表示式
字面量
整數字面量 浮點數字面量 布林字面量 字元字面量	轉義序列 字串字面量 空指標字面量 (C++11) 使用者定義字面量 (C++11)
運算子
賦值運算子 遞增和遞減 算術運算子 邏輯運算子 比較運算子 成員訪問運算子 其他運算子 new 表示式 delete 表示式 throw 表示式	alignof sizeof sizeof... (C++11) typeid noexcept (C++11) 摺疊表示式 (C++17) 運算子的替代表示 優先順序和結合性 運算子過載 預設比較 (C++20)
轉換
隱式轉換 顯式轉換 常用算術轉換     使用者定義轉換	const_cast static_cast dynamic_cast reinterpret_cast

 

浮點字面量定義了一個編譯時常量，其值在原始檔中指定。

語法

數字序列 十進位制指數 字尾 (可選)	(1)
數字序列 . 十進位制指數 (可選) 字尾 (可選)	(2)
數字序列 (可選) . 數字序列 十進位制指數 (可選) 字尾 (可選)	(3)
0x | 0X 十六進位制數字序列 十六進位制指數 字尾 (可選)	(4)	(C++17 起)
0x | 0X 十六進位制數字序列 . 十六進位制指數 字尾 (可選)	(5)	(C++17 起)
0x | 0X 十六進位制數字序列 (可選) . 十六進位制數字序列 十六進位制指數 字尾 (可選)	(6)	(C++17 起)

1) 數字序列表示一個沒有小數分隔符的整數，在這種情況下，指數不是可選的：1e10, 1e-5L。

2) 數字序列表示一個帶小數分隔符的整數，在這種情況下，指數是可選的：1., 1.e-2。

3) 數字序列表示一個小數。指數是可選的：3.14, .1f, 0.1e-1L。

4) 十六進位制 數字序列表示一個沒有基數分隔符的整數。對於十六進位制浮點字面量，指數絕不是可選的：0x1ffp10, 0X0p-1。

5) 十六進位制 數字序列表示一個帶基數分隔符的整數。對於十六進位制浮點字面量，指數絕不是可選的：0x1.p0, 0xf.p-1。

6) 十六進位制 數字序列表示一個帶基數分隔符的分數。對於十六進位制浮點字面量，指數絕不是可選的：0x0.123p-1, 0xa.bp10l。

十進位制指數 的形式是

e | E 指數符號 (可選) 數字序列

十六進位制指數 的形式是

p | P 指數符號 (可選) 數字序列		(C++17 起)

指數符號，如果存在，是 + 或 -

字尾，如果存在，是 f, l, F, L 之一, f16, f32, f64, f128, bf16, F16, F32, F64, F128, BF16(C++23 起)。字尾決定了浮點字面量的型別。

• (無後綴) 定義 double
• f F 定義 float
• l L 定義 long double

f16 F16 定義 std::float16_t f32 F32 定義 std::float32_t f64 F64 定義 std::float64_t f128 F128 定義 std::float128_t bf16 BF16 定義 std::bfloat16_t

(C++23 起)

可選的單引號（'）可以插入數字之間作為分隔符；在確定字面量的值時它們會被忽略。

(C++14 起)

解釋

使用十進位制科學記數法，這意味著浮點字面量的值是有效數字乘以 10 的 十進位制指數 次冪。例如，123e4 的數學含義是 123×10⁴。

如果浮點字面量以字元序列 0x 或 0X 開頭，則該浮點字面量是一個十六進位制浮點字面量。否則，它是一個十進位制浮點字面量。 對於十六進位制浮點字面量，有效數字被解釋為十六進位制有理數，指數的數字序列被解釋為 2 的（十進位制）整數次冪，有效數字需要按此比例縮放。 double d = 0x1.4p3;// 十六進位制分數 1.4（十進位制 1.25）按 23 縮放，即 10.0

(C++17 起)

注意

十六進位制浮點字面量直到 C++17 才成為 C++ 的一部分，儘管自 C++11 以來它們可以透過 I/O 函式進行解析和列印：當 std::hexfloat 啟用時，C++ I/O 流和 C I/O 流都可以：std::printf, std::scanf 等。有關格式說明，請參見 std::strtof。

功能測試宏	值	標準	特性
__cpp_hex_float	201603L	(C++17)	十六進位制浮點字面量

示例

執行此程式碼

#include <iomanip>
#include <iostream>
#include <limits>
#include <typeinfo>
 
#define OUT(x) '\n' << std::setw(16) << #x << x
 
int main()
{
    std::cout
        << "Literal" "\t" "Printed value" << std::left
        << OUT( 58.            ) // double
        << OUT( 4e2            ) // double
        << OUT( 123.456e-67    ) // double
        << OUT( 123.456e-67f   ) // float, truncated to zero
        << OUT( .1E4f          ) // float
        << OUT( 0x10.1p0       ) // double
        << OUT( 0x1p5          ) // double
        << OUT( 0x1e5          ) // integer literal, not floating-point
        << OUT( 3.14'15'92     ) // double, single quotes ignored (C++14)
        << OUT( 1.18e-4932l    ) // long double
        << std::setprecision(39)
        << OUT( 3.4028234e38f  ) // float
        << OUT( 3.4028234e38   ) // double
        << OUT( 3.4028234e38l  ) // long double
        << '\n';
 
    static_assert(3.4028234e38f == std::numeric_limits<float>::max());
 
    static_assert(3.4028234e38f ==  // ends with 4
                  3.4028235e38f);   // ends with 5
 
    static_assert(3.4028234e38 !=   // ends with 4
                  3.4028235e38);    // ends with 5
 
    // Both floating-point constants below are 3.4028234e38
    static_assert(3.4028234e38f !=  // a float (then promoted to double)
                  3.4028234e38);    // a double
}

可能的輸出

Literal         Printed value
58.             58
4e2             400
123.456e-67     1.23456e-65
123.456e-67f    0
.1E4f           1000
0x10.1p0        16.0625
0x1p5           32
0x1e5           485
3.14'15'92      3.14159
1.18e-4932l     1.18e-4932
3.4028234e38f   340282346638528859811704183484516925440
3.4028234e38    340282339999999992395853996843190976512
3.4028234e38l   340282339999999999995912555211526242304

參考

• C++23 標準 (ISO/IEC 14882:2024)

• 5.13.4 浮點字面量 [lex.fcon]

• C++20 標準 (ISO/IEC 14882:2020)

• 5.13.4 浮點字面量 [lex.fcon]

• C++17 標準 (ISO/IEC 14882:2017)

• 5.13.4 浮點字面量 [lex.fcon]

• C++14 標準 (ISO/IEC 14882:2014)

• 2.14.4 浮點字面量 [lex.fcon]

• C++11 標準 (ISO/IEC 14882:2011)

• 2.14.4 浮點字面量 [lex.fcon]

• C++98 標準 (ISO/IEC 14882:1998)

• 2.13.3 浮點字面量 [lex.fcon]

參閱

使用者定義字面量(C++11)	帶使用者定義字尾的字面量
C 文件 關於 浮點常量