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

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

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

Символ #
инструкция препроцессора (одна из define, undef, include, if, ifdef, ifndef, else, elif, elifdef, elifndef (начиная с C23), endif, line, embed (начиная с C23), error, warning (начиная с C23), pragma) ^[1]
аргументы (в зависимости от инструкции)
перевод строки

Допускается пустая директива (# и перевод строки), которая не имеет эффекта.

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

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

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

определяемое реализацией поведение (управляется директивой #pragma и оператором _Pragma (начиная с C99))
имя файла и информация о строке доступны препроцессору (управляется директивой #line)

↑ Это определённые стандартом директивы. Стандарт не определяет поведение других директив: они могут игнорироваться, иметь некоторое полезное значение или сделать программу плохо структурированной. Даже если иное игнорируется, оно удаляется из исходного кода после окончания работы препроцессора. Часто встречающееся нестандартное расширение — это директива #warning, которая генерирует заданное пользователем сообщение во время компиляции. (до C23)

Документация C++ по препроцессору

Язык
Заголовочные файлы
Поддержка типов
Программные утилиты
Поддержка вариативных функций
Обработка ошибок
Управление динамической памятью
Библиотека строк
Алгоритмы
Числа
Утилиты даты и времени
Поддержка ввода/вывода
Поддержка локализации
Поддержка конкурентности (C11)
Технические спецификации
Символьный указатель

#if#ifdef#ifndef#else#elif#elifdef#elifndef#endif (C23)(C23)
#define#undef#,## operators
#include__has_include (C23)
#error#warning (C23)
#pragma_Pragma (C99)
#line
#embed (C23)

Содержание