命名空间
变体
操作

整型字面量

来自 cppreference.cn
< cpp‎ | 语言
 
 
C++ 语言
 
 

允许在表达式中直接使用整型值。

目录

[编辑] 语法

整型字面量具有以下形式

十进制字面量 整型后缀 (可选) (1)
八进制字面量 整型后缀 (可选) (2)
十六进制字面量 整型后缀 (可选) (3)
二进制字面量 整型后缀 (可选) (4) (C++14 起)

其中

  • 十进制字面量 是一个非零十进制数字(1, 2, 3, 4, 5, 6, 7, 8, 9),后跟零个或多个十进制数字(0, 1, 2, 3, 4, 5, 6, 7, 8, 9
  • 八进制字面量 是数字零(0),后跟零个或多个八进制数字(0, 1, 2, 3, 4, 5, 6, 7
  • 十六进制字面量 是字符序列 0x 或字符序列 0X,后跟一个或多个十六进制数字(0, 1, 2, 3, 4, 5, 6, 7, 8, 9, a, A, b, B, c, C, d, D, e, E, f, F
  • 二进制字面量 是字符序列 0b 或字符序列 0B,后跟一个或多个二进制数字(0, 1
  • 整型后缀,如果提供,可能包含以下两者之一或两者(如果两者都提供,它们可以以任意顺序出现)
  • 无符号后缀(字符 u 或字符 U
  • 以下之一
  • 长整型后缀(字符 l 或字符 L
  • 长长整型后缀(字符序列 ll 或字符序列 LL
(C++11 起)
  • 大小后缀(字符 z 或字符 Z
(C++23 起)

可选的单引号 (') 可以插入在数字之间作为分隔符;在确定字面量的值时它们会被忽略。

(C++14 起)

整型字面量(与任何字面量一样)是一个主表达式

[编辑] 解释

1) 十进制整型字面量(基数 10)。
2) 八进制整型字面量(基数 8)。
3) 十六进制整型字面量(基数 16,字母 'a''f' 代表值(十进制)10 到 15)。
4) 二进制整型字面量(基数 2)。

整型字面量的第一个数字是最重要的。

示例。以下变量被初始化为相同的值

int d = 42;
int o = 052;
int x = 0x2a;
int X = 0X2A;
int b = 0b101010; // C++14

示例。以下变量也被初始化为相同的值

unsigned long long l1 = 18446744073709550592ull;       // C++11
unsigned long long l2 = 18'446'744'073'709'550'592llu; // C++14
unsigned long long l3 = 1844'6744'0737'0955'0592uLL;   // C++14
unsigned long long l4 = 184467'440737'0'95505'92LLU;   // C++14

[编辑] 字面量的类型

整型字面量的类型是其值能够容纳的第一个类型,该类型列表取决于使用的数字基数和整型后缀

后缀 十进制基数 二进制、八进制或十六进制基数
(无后缀)
  • int
  • long int
  • long long int (C++11 起)
  • int
  • unsigned int
  • long int
  • unsigned long int
  • long long int (C++11 起)
  • unsigned long long int (C++11 起)
uU
  • unsigned int
  • unsigned long int
  • unsigned long long int (C++11 起)
  • unsigned int
  • unsigned long int
  • unsigned long long int (C++11 起)
lL
  • long int
  • unsigned long int (C++11 之前)
  • long long int (C++11 起)
  • long int
  • unsigned long int
  • long long int (C++11 起)
  • unsigned long long int (C++11 起)
l/L
u/U
  • unsigned long int
  • unsigned long long int (C++11 起)
  • unsigned long int
  • unsigned long long int (C++11 起)
llLL
  • long long int (C++11 起)
  • long long int (C++11 起)
  • unsigned long long int (C++11 起)
ll/LL
u/U
  • unsigned long long int (C++11 起)
  • unsigned long long int (C++11 起)
zZ
z/Z
u/U

如果整型字面量的值不带大小后缀(C++23 起)太大而无法放入由后缀/基数组合允许的任何类型中,并且编译器支持可以表示该字面量值的扩展整型(例如__int128),则该字面量可以被赋予该扩展整型——否则程序格式错误。

[编辑] 注意

整型字面量中的字母不区分大小写:0xDeAdBeEfU0XdeadBEEFu 代表相同的数字(一个例外是长长整型后缀,它必须是 llLL,绝不能是 lLLl(C++11 起)

不存在负整型字面量。像-1这样的表达式是将一元减号运算符应用于字面量所表示的值,这可能涉及隐式类型转换。

在 C99 之前的 C 语言中(但不在 C++ 中),不带后缀的十进制值如果不能放入long int,则允许其类型为unsigned long int

#if#elif 的控制表达式中使用时,所有有符号整型常量都表现得好像它们具有类型 std::intmax_t,所有无符号整型常量都表现得好像它们具有类型 std::uintmax_t

(C++11 起)

由于最大吞噬规则,以 eE 结尾的十六进制整型字面量,当后面跟着运算符 +- 时,必须在源代码中用空格或括号将其与运算符分开

auto x = 0xE+2.0;   // error
auto y = 0xa+2.0;   // OK
auto z = 0xE +2.0;  // OK
auto q = (0xE)+2.0; // OK

否则,会形成一个无效的预处理数字标记,导致进一步的分析失败。

特性测试 标准 特性
__cpp_binary_literals 201304L (C++14) 二进制字面量
__cpp_size_t_suffix 202011L (C++23) std::size_t 及其有符号版本的字面量后缀

[编辑] 示例

#include <cstddef>
#include <iostream>
#include <type_traits>
 
int main()
{
    std::cout << 123 << '\n'
              << 0123 << '\n'
              << 0x123 << '\n'
              << 0b10 << '\n'
              << 12345678901234567890ull << '\n'
              << 12345678901234567890u << '\n'; // the type is unsigned long long
                                                // even without a long long suffix
 
//  std::cout << -9223372036854775808 << '\n'; // error: the value
               // 9223372036854775808 cannot fit in signed long long, which is the
               // biggest type allowed for unsuffixed decimal integer literal
    std::cout << -9223372036854775808u << '\n'; // unary minus applied to unsigned
               // value subtracts it from 2^64, this gives 9223372036854775808
    std::cout << -9223372036854775807 - 1 << '\n'; // correct way to calculate
                                                   // the value -9223372036854775808
 
#if __cpp_size_t_suffix >= 202011L // C++23
    static_assert(std::is_same_v<decltype(0UZ), std::size_t>);
    static_assert(std::is_same_v<decltype(0Z), std::make_signed_t<std::size_t>>);
#endif
}

输出

123
83
291
2
12345678901234567890
12345678901234567890
9223372036854775808
-9223372036854775808

[编辑] 缺陷报告

下列更改行为的缺陷报告追溯地应用于以前出版的 C++ 标准。

缺陷报告 应用于 发布时的行为 正确的行为
CWG 2698 C++23 大小后缀的整型字面量可能具有扩展整型 如果太大则格式错误

[编辑] 参考

  • C++23 标准 (ISO/IEC 14882:2024)
  • 5.13.2 整型字面量 [lex.icon]
  • C++20 标准 (ISO/IEC 14882:2020)
  • 5.13.2 整型字面量 [lex.icon]
  • C++17 标准 (ISO/IEC 14882:2017)
  • 5.13.2 整型字面量 [lex.icon]
  • C++14 标准 (ISO/IEC 14882:2014)
  • 2.14.2 整型字面量 [lex.icon]
  • C++11 标准 (ISO/IEC 14882:2011)
  • 2.14.2 整型字面量 [lex.icon]
  • C++98 标准 (ISO/IEC 14882:1998)
  • 2.13.1 整型字面量 [lex.icon]

[编辑] 另请参阅

用户定义字面量(C++11) 带用户定义后缀的字面量[编辑]
C 文档 关于 整型常量