文件名和行信息
来自cppreference.com
< cpp | preprocessor
更改预处理器中的行号,也可以同时更改当前文件名。
语法
#line 行号 换行
|
(1) | ||||||||
#line 行号 "文件名" 换行
|
(2) | ||||||||
#line 记号序列 换行
|
(3) | ||||||||
1) 将当前的预处理器行号更改为行号。
2) 还将当前的预处理器文件名更改为文件名。
3) 如果 (1) 和 (2) 都不匹配,记号序列 会经历宏替换。该指令在替换后会再次尝试匹配 (1) 和 (2)。
| 换行 | - | 换行字符 |
| 行号 | - | 一个或多个十进制数位(0 到 9)的序列,数位之间可插入单引号(')作为分隔符(C++14 起)
|
| 文件名 | - | 一个或多个s字符(见字符串字面量)的序列 |
| 记号序列 | - | 一个或多个预处理记号的序列 |
解释
宏 __LINE__ 在 #line 指令后的展开将产生行号 加上自此遇到的实际代码行数。如果提供了文件名,那么宏 __FILE__ 在该点后的展开将生成文件名。
如果行号 表示的十进制数字是 0 或该数字大于 32767(C++11 前)2147483647(C++11 起),那么行为未定义(C++26 前)程序非良构(C++26 起)。
注解
一些自动代码生成工具通过以其他语言编写的文件产生 C++ 源文件时,会使用此指令。这种情况下,它们在所生成的 C++ 文件中插入 #line 指令,以指代原(人类编辑的)源文件的行号和文件名。
示例
运行此代码
#include <cassert>
#define FNAME "test.cc"
int main()
{
#line 777 FNAME
assert(2+2 == 5);
}
可能的输出:
test: test.cc:777: int main(): Assertion `2+2 == 5' failed.
引用
- C++23 标准(ISO/IEC 14882:2024):
- 15.7 Line control [cpp.line]
- C++20 标准(ISO/IEC 14882:2020):
- 15.7 Line control [cpp.line]
- C++17 标准(ISO/IEC 14882:2017):
- 19.4 Line control [cpp.line]
- C++14 标准(ISO/IEC 14882:2014):
- 16.4 Line control [cpp.line]
- C++11 标准(ISO/IEC 14882:2011):
- 16.4 Line control [cpp.line]
- C++98 标准(ISO/IEC 14882:1998):
- 16.4 Line control [cpp.line]
参阅
(C++20) |
表示关于源代码的信息(例如文件名、行号以及函数名)的类 (类) |
文件名和行信息的 C 文档
| |