Spec-Zone.ru › GCC 9 CPP

6 Управление строками

Препроцессор C сообщает компилятору C о местоположении в исходном коде каждого токена. В настоящее время это просто имя файла и номер строки. Все токены, полученные в результате макроподстановки, отчитываются как появившиеся в строке исходного файла, где был использован внешний макрос. В будущем мы планируем повысить точность.

Если вы пишете программу, которая генерирует исходный код, например, генератор парсера bison, вы можете вручную скорректировать представление препроцессора о текущем имени файла и номере строки. Части вывода bison генерируются с нуля, другие части взяты из стандартного файла парсера. Остальные скопированы дословно из входных данных bison. Вы хотите, чтобы сообщения об ошибках компилятора и символические отладчики могли ссылаться на входной файл bison.

bison или любая подобная программа может организовать это, записав директивы ‘#line’ в выходной файл. ‘#line’ — это директива, которая задаёт исходный номер строки и имя исходного файла для последующего ввода в текущем входном файле препроцессора. ‘#line’ имеет три варианта:

#line linenum

linenum — это целочисленная константа с неотрицательным десятичным значением. Она задаёт номер строки, который должен отображаться для следующей строки ввода. Последующие строки считаются от linenum.

#line linenum filename

linenum — то же самое, что и в первом варианте, и имеет тот же эффект. Кроме того, filename — это строковая константа. Следующая строка и все последующие строки отчитываются как взятые из указанного файла, до тех пор, пока что-то не изменит это. filename интерпретируется по обычным правилам для строковых констант: обратные слэши интерпретируются. Это отличается от ‘#include’.

#line anything else

anything else проверяется на наличие вызовов макросов, которые расширяются. Результат должен соответствовать одному из вышеперечисленных двух вариантов.

Директивы ‘#line’ изменяют результаты предопределённых макросов __FILE__ и __LINE__ с этого момента. См. Стандартные предопределённые макросы. Они не оказывают никакого влияния на представление ‘#include’ о каталоге, содержащем текущий файл.

Далее: Директивы, Предыдущее: Диагностика, Вверх: Главная страница [Содержание][Индекс]

© Free Software Foundation
Licensed under the GNU Free Documentation License, Version 1.3.
https://gcc.gnu.org/onlinedocs/gcc-9.5.0/cpp/Line-Control.html

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API