文件名和行信息
来自cppreference.com
< cpp | preprocessor
更改预处理器中的行号,可选地更改当前文件名。
语法
#line 行号
|
(1) | ||||||||
#line 行号 " 文件名"
|
(2) | ||||||||
解释
1) 将当前的预处理器行号更改为 行号。宏 __LINE__ 在该点后的展开将产生 行号 加上自此遇到的实际代码行数。
2) 还将当前的预处理器文件名更改为 文件名。宏 __FILE__ 在该点后的展开将生成 文件名。
任何预处理器记号(宏常量或表达式)都允许作为 #line 的实参,只要它们展开成合法的十进制整数,可选地后随一个合法的字符串即可。
行号 必须是至少有一个十进制位的序列(否则程序非良构),并且始终按十进制解释(即使它以 0
开始也是如此)。
若 行号 为 0 或大于 32767 (C++11 前)2147483647 (C++11 起),则行为未定义。
注解
一些自动代码生成工具通过以其他语言编写的文件产生 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) |
表示关于源代码的信息(例如文件名、行号以及函数名)的类 (类) |