Spec-Zone.ru › GCC 7 CPP

10.2 Традиционные макросы

Основное различие между традиционными и ISO-макросами заключается в том, что первые расширяются до текста, а не до последовательности токенов. CPP удаляет все начальные и конечные горизонтальные пробелы из текста замены макроса перед его сохранением, но сохраняет форму внутренних пробелов.

Одним из следствий является то, что в тексте замены допустимо наличие непарной кавычки (см. Традиционный лексический анализ). Незакрытая строка или символьная константа продолжается в текст, следующий за вызовом макроса. Аналогично, текст в конце расширения макроса может слиться с текстом после вызова макроса, образуя один токен.

Обычно комментарии удаляются из текста замены после расширения макроса, но если опция -CC передается в командной строке, комментарии сохраняются. (На самом деле, текущая реализация удаляет комментарии даже до сохранения текста замены макроса, но делает это таким образом, что наблюдаемый эффект идентичен даже в случае макросов типа функций.)

Оператор строкового преобразования ISO ‘#’ и оператор склеивания токенов ‘##’ не имеют специального значения. Как объясняется позднее, эффект, аналогичный этим операторам, может быть получен другим способом. Имена макросов, которые заключены в кавычки, либо из основного файла, либо после замены макроса, не расширяются.

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

#define PLUS +
#define INC(x) PLUS+x
INC(foo);
     → ++foo;

Макросы типа функций похожи по форме, но значительно отличаются по поведению от своих аналогов ISO. Их аргументы заключены в скобки, разделены запятыми и могут переноситься на разные физические строки. Запятые внутри вложенных скобок не обрабатываются как разделители аргументов. Аналогично, кавычка в аргументе не может оставаться незакрытой; следующая запятая или скобка, которая появляется перед закрывающей кавычкой, обрабатывается как любой другой символ. Нет механизма для обработки макросов с переменным числом аргументов.

Эта реализация удаляет все комментарии из аргументов макроса, если не задана опция -C. Форма всех других горизонтальных пробелов в аргументах сохраняется, включая начальные и конечные пробелы. В частности

f( )

обрабатывается как вызов макроса ‘f’ с одним аргументом, состоящим из одного пробела. Если вы хотите вызвать макрос типа функции, который не принимает аргументов, вы не должны оставлять никаких пробелов между скобками.

Если аргумент макроса переносится на новую строку, новая строка заменяется пробелом при формировании аргумента. Если предыдущая строка содержала незакрытую кавычку, следующая строка наследует состояние кавычки.

Традиционные препроцессоры заменяют параметры в тексте замены своими аргументами независимо от того, находятся ли параметры в кавычках или нет. Это предоставляет способ строкового преобразования аргументов. Например

#define str(x) "x"
str(/* A comment */some text )
     → "some text "

Обратите внимание, что комментарий удаляется, но конечный пробел сохраняется. Вот пример использования комментария для эффекта склеивания токенов.

#define suffix(x) foo_/**/x
suffix(bar)
     → foo_bar

Далее: Традиционные разные моменты, Предыдущее: Традиционный лексический анализ, Наверх: Традиционный режим [Содержание][Индекс]

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

Spec-Zone.ru

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