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

 

C++

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

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

Язык

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

 

Язык С++

Общие темы
Препроцессор Комментарии	Ключевые слова Escape последовательности
Управление потоком
Операторы условного выполнения
if	switch
Операторы итераций (циклы)
for диапазонный for (C++11)	while do-while
Операторы переходов
continue - break	goto - return
Функции
Объявление функции
Выражение лямбда-функции
Спецификатор inline
Спецификации динамических исключений (до C++20)
Спецификатор 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)
Типы
Объявление typedef
Объявление псевдонима типа (C++11)
Приведения
Неявные преобразования - Явные преобразования
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, которая выдаёт определяемое пользователем сообщение во время компиляции), или
• ничего, в этом случае директива ничего не делает.

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

Директивы 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))
• вызов ошибки или warning (начиная с C++23) (контролируется директивой #error или #warning соответственно (начиная с C++23))

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

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

Отчёты о дефектах

Следующие изменения поведения были применены с обратной силой к ранее опубликованным стандартам C++:

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

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

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

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

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