文件名和行信息

来自cppreference.com


 
 
C++ 语言
 
 

更改预处理器中的行号,也可以同时更改当前文件名。

语法

#line 行号 换行 (1)
#line 行号 "文件名" 换行 (2)
#line 记号序列 换行 (3)
1) 将当前的预处理器行号更改为行号
2) 还将当前的预处理器文件名更改为文件名
3) 如果 (1)(2) 都不匹配,记号序列 会经历宏替换。该指令在替换后会再次尝试匹配 (1)(2)
换行 - 换行字符
行号 - 一个或多个十进制数位(09)的序列,数位之间可插入单引号(')作为分隔符(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 文档