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

 

C++

Поддержка компилятором

Автономные и размещённые реализации

Язык

Стандартная библиотека

Заголовки стандартной библиотеки

Требования к именованию

Макросы тестирования функциональности (C++20)

Поддержка языка

Библиотека концептов (C++20)

Библиотека метапрограммирования (C++11)

Библиотека диагностики

Библиотека общих утилит

Библиотека строк

Библиотека контейнеров

Библиотека итераторов

Библиотека диапазонов (C++20)

Библиотека алгоритмов

Библиотека численных данных

Библиотека ввода/вывода

Библиотека локализаций

Регулярные выражения (C++11)

Атомарные операции (C++11)

Библиотека поддержки конкуренции (C++11)

Библиотека файловой системы (C++17)

Технические спецификации

Указатель символов

Внешние библиотеки

 

Язык С++

Общие темы
Препроцессор Комментарии	Ключевые слова Управляющие последовательности
Управление потоком
Операторы условного выполнения
if	switch
Операторы итерации (циклы)
for диапазонный for (C++11)	while do-while
Операторы перехода
continue - break	goto - return
Функции
Объявление функции
Выражение лямбда-функции
Спецификатор inline
Спецификации динамических исключений (до C++17*)
Спецификатор noexcept (C++11)
Исключения
Выражение throw	Блок try-catch
Пространства имён
Объявление пространства имён	Псевдонимы пространств имён
Типы
Основные типы Типы перечислений Типы функций	Типы классов/структур Типы объединений
Спецификаторы
decltype (C++11) auto (C++11) alignas (C++11)	const/volatile constexpr (C++11)
Спецификаторы длительности хранения
Инициализация
Инициализация по умолчанию Инициализация значением Инициализация нулём Инициализация копированием Прямая инициализация	Агрегатная инициализация     Инициализация списком (C++11) Константная инициализация Инициализация ссылки

Выражения
Категории значений Порядок оценки	Операторы Приоритет оператора
Альтернативные представления
Литералы
Логические - Целочисленные - С плавающей запятой
Символьные - Строковые - nullptr (C++11)
Определяемые пользователем (C++11)
Утилиты
Атрибуты (C++11)
Types
Объявление typedef
Объявление псевдонима типа (C++11)
Casts
Неявные преобразования - Явные преобразования
static_cast - dynamic_cast
const_cast - reinterpret_cast
Выделение памяти
Выражение new	Выражение delete
Классы
Объявление класса Конструкторы Указатель this	Спецификаторы доступа Спецификатор friend
Свойства функции класса
Виртуальная функция Спецификатор override (C++11)       Спецификатор final (C++11)	explicit (C++11) static
Специальные функции-элементы
Конструктор по умолчанию Конструктор копирования Конструктор перемещения (C++11)	Присваивание копированием Присваивание перемещением (C++11) Деструктор
Шаблоны
Шаблон класса Шаблон функции	Специализация шаблона Пакеты параметров (C++11)
Разное
Встроенный ассемблер	История C++

 

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

#if#ifdef#ifndef#else#elif#elifdef#elifndef#endif (C++23)(C++23)

#define#undefоператоры #,##

#include__has_include (C++17)

#error#warning (C++23)

#pragma_Pragma (C++11)

#line

 

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

Директивы

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

• символ #
• последовательность:

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

• перевод строки

Директивы module и import также являются директивами препроцесснинга.

(начиная с C++20)

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

#define EMPTY
EMPTY   #   include <file.h> // не директива препроцессинга

Возможности

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

• условная компиляция частей исходного файла (контролируется директивами #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++:

Номер	Применён	Поведение в стандарте	Корректное поведение
CWG 2001	C++98	поведение при использовании нестандартно определённых директив было неясным	сделано условно поддерживаемым

Смотрите также

Документация C++ по Предопределённые Макро Символы

Документация C++ по Указатель Макро Символов

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