浮点字面量

浮点字面量定义了一个编译时常量，其值在源文件中指定。


数字序列十进制指数后缀 (可选)	(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）按 2³ 缩放，即 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 文档关于浮点常量

编译器支持
自由（freestanding）与宿主（hosted）
语言
标准库
标准库头文件
具名要求
特性测试宏 (C++20)
语言支持库
概念库 (C++20)
诊断库
内存管理库
元编程库 (C++11)
通用工具库
容器库
迭代器库
范围库 (C++20)
算法库
字符串库
文本处理库
数值库
日期和时间库
输入/输出库
文件系统库 (C++17)
并发支持库 (C++11)
执行控制库 (C++26)
技术规范
符号索引
外部库

cppreference.cn

命名空间

变体

视图

操作