文件名和行信息
来自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 FNAMEassert(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 文档 |