Информация о имени файла и строке
Изменяет номер строки исходного кода и, необязательно, текущее имя файла в препроцессоре.
Синтаксис
#line номер-строки
|
(1) | ||||||||
#line номер-строки "имя-файла"
|
(2) | ||||||||
Объяснение
1) Изменяет текущий номер строки препроцессора на номер-строки. Расширения макроса __LINE__ за пределами этой точки будут расширяться до номер-строки плюс количество фактических строк исходного кода, встреченных до него.
2) Также изменяет имя текущего файла препроцессора на имя-файла. Расширение макроса __FILE__ с этого момента приведёт к выдаче имени-файла.
Любые маркеры предварительной обработки (макроконстанты или выражения) разрешены в качестве аргументов для #line до тех пор, пока они расширяются до допустимого десятичного целого числа, и необязательно следующей за ним допустимой строки символов.
номер-строки должен быть последовательностью, состоящей как минимум из одной десятичной цифры (в противном случае программа некорректна) и всегда интерпретируется как десятичное число (даже если оно начинается с 0).
Если номер-строки равен 0 или больше, чем 32767 (до C++11)2147483647 (начиная с C++11), поведение не определено.
Примечание
Эта директива используется некоторыми инструментами автоматической генерации кода, которые создают исходные файлы C++ из файла, написанного на другом языке. В этом случае директивы #line могут быть вставлены в сгенерированный файл C++, ссылаясь на номера строк и имя файла первоначального (редактируемого человеком) исходного файла.
Пример
#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:2023):
- 15.7 Управление строкой [cpp.line]
- C++20 стандарт (ISO/IEC 14882:2020):
- 15.7 Управление строкой [cpp.line]
- C++17 стандарт (ISO/IEC 14882:2017):
- 19.4 Управление строкой [cpp.line]
- C++14 стандарт (ISO/IEC 14882:2014):
- 16.4 Управление строкой [cpp.line]
- C++11 стандарт (ISO/IEC 14882:2011):
- 16.4 Управление строкой [cpp.line]
- C++98 стандарт (ISO/IEC 14882:1998):
- 16.4 Управление строкой [cpp.line]
Смотрите также
(C++20) |
класс, предоставляющий информацию об исходном коде, такую как имена файлов, номера строк и имена функций (класс) |
Документация C по Информация о имени файла и строке
| |