Препроцессор

Препроцессор выполняется на фазе трансляции 4, до компиляции. Результатом препроцессирования является единый файл, который затем передаётся непосредственно компилятору.

Директивы

Директивы препроцессирования управляют поведением препроцессора. Каждая директива занимает одну строку и имеет следующий формат:

• символ #.
• последовательность из:
• имени директивы, определённого стандартом (перечислены ниже), за которым следуют соответствующие аргументы, или
• одного или нескольких токенов препроцессирования, где начальный токен не является именем директивы, определённым стандартом; в этом случае директива является условно поддерживаемой с семантикой, определяемой реализацией (например, распространённым нестандартным расширением является директива #warning, которая выводит пользовательское сообщение во время компиляции)(до C++23), или
• ничего; в этом случае директива не оказывает никакого эффекта.
• перевод строки.

Директивы препроцессирования не должны быть результатом раскрытия макроса.

#define EMPTY
EMPTY   #   include <file.h> // not a preprocessing directive

Возможности

Препроцессор предоставляет следующие возможности преобразования исходного файла:

• условно компилировать части исходного файла (управляется директивами #if, #ifdef, #ifndef, #else, #elif, #elifdef, #elifndef(начиная с C++23) и #endif).
• заменять текстовые макросы, при необходимости объединяя или заключая в кавычки идентификаторы (управляется директивами #define и #undef, а также операторами # и ##).
• включать другие файлы (управляется директивой #include и проверяется с помощью __has_include(начиная с C++17)).
• вызывать ошибку или предупреждение(начиная с C++23) (управляется директивой #error или #warning соответственно(начиная с C++23)).

Можно управлять следующими аспектами работы препроцессора:

• поведением, определяемым реализацией (управляется директивой #pragma и оператором _Pragma(начиная с C++11)). Кроме того, некоторые компиляторы в разной степени поддерживают оператор __pragma как нестандартное расширение.
• имя файла и информацию о строке, доступные препроцессору (управляется директивой #line).

Отчёты об ошибках

Следующие отчёты об ошибках, изменяющие поведение, были применены задним числом к ранее опубликованным стандартам C++.

См. также