Просмотр кода страницы cpp/preprocessor

У вас нет прав на выполнение действия «редактирование этой страницы» по следующей причине:

Запрошенное действие могут выполнять участники одной из следующих г��упп: Участники, Администраторы.

Вы можете просмотреть и скопировать исходный код этой страницы.

{{title|Препроцессор}}
{{cpp/preprocessor/navbar}}
Препроцессор выполняется во время выполнения [[cpp/language/translation_phases|фазы трансляции 4]], перед компиляцией. Результатом препроцессинга является единственный файл, который затем передаётся фактическому компилятору.

===Директивы===

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

* символ {{c|#}}
* последовательность:
:* стандартное имя директивы (перечисленные [[#Возможности|ниже]]), за которым следуют соответствующие аргументы, или
:* один или несколько [[cpp/language/translation phases#Фаза 3|токенов предварительной обработки]], где начальный токен не является стандартным именем директивы, в этом случае директива поддерживается условно с семантикой, определяемой реализацией{{rev inl|until=c++23| (например, общее нестандартное расширение это директива {{c|#warning}}, которая выдаёт определяемое пользователем сообщение во время компиляции)}}, или
:* ничего, в этом случае директива ничего не делает.
* перевод строки

{{rrev|since=c++20|
[[cpp/language/modules|Директивы module и import]] также являются директивами препроцесснинга.
}}

Директивы препроцессинга не должны исходить из раскрытия макроса.
{{source|1=
#define EMPTY
EMPTY   #   include <file.h> // не директива препроцессинга
}}

===Возможности===

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

* '''{{rl | conditional | условная}}''' компиляция частей исходного файла (контролируется директивами {{c|#if}}, {{c|#ifdef}}, {{c|#ifndef}}, {{c|#else}}, {{c|#elif}},{{rev inl|since=c++23| {{c|#elifdef}}, {{c|#elifndef}}}} и {{c|#endif}})
* '''{{rl | replace | замена}}''' текстовых макросов с возможностью конкатенации и заключения в кавычки идентификаторов (контролируется директивами {{c|#define}} и {{c|#undef}} и операторами {{c|#}} и {{c|##}})
* '''{{rl | include | включение}}''' других файлов (контролируется директивой {{c|#include}} {{rev inl|since=c++17|и проверяется {{tt|__has_include}}}})
* вызов '''{{rl | error | ошибки}}''' {{rev inl|since=c++23|или '''{{rl|error|предупреждения}}'''}} (контролируется директивой {{c|#error}}{{rev inl|since=c++23| или {{c|#warning}} соответственно}})

Можно управлять следующими аспектами препроцессора:
* '''{{rl | impl | определяемым реализацией}}''' поведением (управляется директивой {{c|#pragma}} {{rev inl|since=c++11| и оператором {{tt|_Pragma}}}}). Кроме того, некоторые компиляторы поддерживают (в той или иной степени) оператор {{tt|__pragma}} как ''нестандартное'' расширение.
* '''{{rl | line | информацией об имени файла и номере строки}}''', доступной препроцессору (управляется директивой {{c|#line}})

===Отчёты о дефектах===
{{dr list begin}}
{{dr list item|wg=cwg|dr=2001|std=C++98|before=поведение при использовании нестандартно определённых<br>директив было неясным|after=сделано условно поддерживаемым}}
{{dr list end}}

===Смотрите также===
{{dsc begin}}
{{dsc see cpp | cpp/preprocessor/replace#Predefined_macros | Предопределённые Макро Символы | nomono=true}}
{{dsc see cpp | cpp/symbol_index/macro | Указатель Макро Символов | nomono=true}}
{{dsc see c | c/preprocessor|препроцессора | nomono=true}}
{{dsc end}}

{{langlinks|ar|cs|de|en|es|fr|it|ja|ko|pl|pt|tr|zh}}

Шаблоны, используемые на этой странице:

Возврат к странице cpp/preprocessor.

cppreference.com

Поиск

Пространства имён

Варианты

Просмотры

Действия

Просмотр кода страницы cpp/preprocessor

Навигация

Инструменты