Spec-Zone.ru › GCC 8

6.20 Макросы с переменным числом аргументов.

В стандарте ISO C 1999 макрос может быть объявлен так, чтобы принимать переменное число аргументов, подобно функции. Синтаксис определения макроса аналогичен синтаксису функции. Вот пример:

#define debug(format, ...) fprintf (stderr, format, __VA_ARGS__)

Здесь ‘…’ — переменные аргументы. При вызове такого макроса он представляет собой ноль или более токенов до закрывающей скобки, завершающей вызов, включая любые запятые. Этот набор токенов заменяет идентификатор __VA_ARGS__ в теле макроса там, где он встречается. Для получения дополнительной информации см. руководство по CPP.

GCC давно поддерживает макросы с переменным числом аргументов и использует другой синтаксис, который позволяет присвоить имя переменным аргументам, как и любому другому аргументу. Вот пример:

#define debug(format, args...) fprintf (stderr, format, args)

Это во всех отношениях эквивалентно приведенному выше примеру ISO C, но, возможно, более читаемо и описательно.

GNU CPP имеет два дополнительных расширения макросов с переменным числом аргументов и позволяет использовать их с любой из вышеперечисленных форм определения макроса.

В стандартном C вы не можете опустить аргумент с переменным числом аргументов полностью; но вы можете передать пустой аргумент. Например, этот вызов недействителен в ISO C, так как после строки нет запятой:

debug ("A message")

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

Для решения этой проблемы CPP ведет себя особым образом для переменных аргументов, используемых с оператором склеивания токенов ‘##’. Если вместо этого вы напишете

#define debug(format, ...) fprintf (stderr, format, ## __VA_ARGS__)

и если переменные аргументы опущены или пустые, оператор ‘##’ заставляет препроцессор удалить запятую перед ним. Если вы предоставляете некоторые переменные аргументы в своем вызове макроса, GNU CPP не жалуется на операцию склеивания, а вместо этого помещает переменные аргументы после запятой. Как и любой другой аргумент склеенного макроса, эти аргументы не обрабатываются макрорасширением.

Далее: Управляемые переводы строк, Предыдущий: Переменная длина, Вверх: Расширения C [Содержание][Индекс]

© Free Software Foundation
Licensed under the GNU Free Documentation License, Version 1.3.
https://gcc.gnu.org/onlinedocs/gcc-8.5.0/gcc/Variadic-Macros.html

Spec-Zone.ru

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