Си++/Препроцессорные директивы: различия между версиями

м
орфография, стилевые правки, пунктуация, оформление
(→‎Директива #include: Завершение предыдущей правки.)
Метки: правка с мобильного устройства правка из мобильной версии
м (орфография, стилевые правки, пунктуация, оформление)
 
 
Таких команд немного, они все начинаются со знака решётки (<code>#</code>) и должны быть в начале строки исходного кода:
;<code>[[#Директива define|#define]]</code>: эта директива предусматривает определение [[w:макрос|макросов]] или препроцессорных идентификаторов, простейшее применение это замены в тексте программы.
;<code>[[#Директива include|#include]]</code>: позволяет включать текст других файлов в текст вашей программы.
;<code>[[#Директива undef|#undef]]</code>: отменяет действие директивы [[#Директива define|#define]]
;<code>[[#Условные директивы #if, #ifdef, #else, #endif, #elif|#if]]</code>: организация условной обработки директив.
;<code>[[#Условные директивы #if, #ifdef, #else, #endif, #elif|#ifdef]]</code>: организация условной обработки директивдирективю
;<code>[[#Условные директивы #if, #ifdef, #else, #endif, #elif|#else]]</code>: организация условной обработки директив.
;<code>[[#Условные директивы #if, #ifdef, #else, #endif, #elif|#endif]]</code>: организация условной обработки директив.
;<code>[[#Условные директивы #if, #ifdef, #else, #endif, #elif|#elif]]</code>: организация условной обработки директив.
;<code>[[#Директива line|#line]]</code>: управление нумерацией строк в тексте программы.
;<code>[[#Директива error|#error]]</code>:задает задаёт текст диагностического сообщения, выводящиеся при наличии ошибок.
;<code>[[#Директива pragma|#pragma]]</code>: зависит от среды разработки.
;<code>#</code>: нулевая, или пустая, директива, бездейственно пропускается.
 
__NOTOC__
===Директива #define===
Директива <code>#define</code> служит для замены часто использующихся констант, ключевых слов, операторов или выражений некоторыми идентификаторами. Идентификаторы, заменяющие текстовые или числовые константы, называют именованными константами. Идентификаторы, заменяющие фрагменты программ, называют макроопределениями, причемпричём макроопределения могут иметь аргументы.
 
Основная форма синтаксиса директивы <code>#define</code>:
#define идентификатор текст''
 
Так например, в программе:
 
#define N 5
Директива #include информирует препроцессор о том, что содержание файла с заданным именем следует обрабатывать так, как будто оно присутствует в исходной программе в месте расположения этой директивы. Новый текст также может содержать директивы препроцессора. Препроцессор выполняет директивы в новом тексте, а затем продолжает обработку текста исходного файла.
 
"''Спецификация пути"'' это имя файла, которому может предшествовать директорияимя каталога. Это должно быть имя существующего файла. Синтаксис спецификации файла зависит от операционной системы, в которой компилируется программа.
 
При поиске файлов препроцессор использует концепцию "стандартной"«стандартного» директориикаталога. Расположение стандартных директорийкаталогов для файлов зависит от реализации и операционной системы. Определение стандартнойстандартного директориикаталога можно найти в Вашем Руководстверуководстве по компилятору.
 
Препроцессор останавливает поиск сразу же после обнаружения файла с заданным именем. Если задать полную спецификацию файла, заключенную в двойные цитатные скобкикавычки (<code>" "</code>), то препроцессор использует еееё для поиска и игнорирует стандартнуюстандартный директориюкаталог.
 
Если заключенная в двойные цитатные скобкикавычки спецификация файла является неполной, то препроцессор сначала ищет директориюкаталог "«родительского"» файла. Родительский файл это файл, содержащий директиву #include. Например, если файл f2 вставляется в файл f1, то f1 будет родительским файлом.
 
Вставка файлов может быть вложенной. Т. е. директива #include может появляться в файле, который сам вставляется директивой #include. Файл f2 может вызывать файл f3. В этом случае f1 все еще будет родительским для f2, но "«дедушкой"» для f3.
 
При вложенной вставке файлов поиск директориикаталогов начинается с родительского файла, затем проходит по дедушкиным файлам. Следовательно, поиск начинается в директориикаталоге, котораякоторый содержит обрабатываемый исходный файл. Если файл не найден, то поиск продолжается в директорияхкаталогах, заданных в командной строке компилятора. И, наконец, производится поиск в стандартнойстандартном директориикаталоге.
 
Если спецификация файла заключена в угловые скобки (<code><nowiki>< ></nowiki></code>), то препроцессор не проводит поиска в текущем рабочем каталоге. Поиск файла начинается в директорияхкаталогах, заданныйзаданных в командной строке компилятора, а затем в стандартнойстандартном директориикаталоге.
 
Допускается вложение вставки файлов до 10 уровней. При обработке вложенных #include препроцессор всегда будет осуществлять вставку в первоначальный исходный файл.
 
===Директива #undef===
Директива #undef удаляет текущее определение идентификатора. Поэтому все встречающиеся появления идентификатора будут игнорироваться предпроцессором. Для удаления определения макро с использованием #undef, нужно задать только идентификатор макро, не задавая список параметров.
 
Можно применить директиву #undef к идентификатору, у которого нет определения. Тем самым пользователь получает дополнительную гарантию того, что данный идентификатор не определенопределён.
 
Директива #undef обычно используется в паре с директивой #define для задания области исходной программы, в которой идентификатор имеет специальное значение. Например, некоторая функция исходной программы может иметь объявленные константы, которые задают значения среды работы, которые не влияют на остальную часть программы. Директива #undef также работает с директивой #if для управления условной компиляцией исходной программы.
===Условные директивы #if, #ifdef, #else, #endif, #elif===
Эти директивы позволяют подавить компиляцию части исходного файла, проверяя постоянное выражение или идентификатор. Результат проверки определяет, какие блоки текста будут переданы в компилятор и какие блоки текста будут удалены из исходного файла при предпроцессорной обработке.
 
====Условная компиляция====
 
===Директива #line===
Изменяет внутренний номер строки и имя файла компилятора. Если имя файла опущено, оно остается прежним. Cинтаксис директивы:
#line константа <"имя_файла">
к примеру <code>#line 1000 "file.сpp"</code> устанавливается имя исходного файла file.сpp и текущий номер строки 1000.
Текущий номер строки и имя файла доступны через константы препроцессора __LINE__ и __FILE__.
 
===Директива #error===
Директива #error создаетсоздаёт заданное пользователем сообщение об ошибке во время компиляции, а затем завершает компиляцию.
 
- Синтаксис:
#errortoken-string
 
- Синтаксис:
- Заметки:
#errortoken-string
 
Примечание: Сообщение об ошибке, создаваемое этой директивой, содержит параметр token-string. Параметр token-string не подлежит расширению макроса. Эта директива наиболее полезна в ходе предварительной обработки и позволяет уведомлять разработчика о противоречиях в программе или о нарушении ограничений. В следующем примере демонстрируется обработка ошибки во время предварительной обработки.
 
- Пример использования:
#if !defined(__cplusplus)
#error C++ compiler required.
#endif
 
===Директива #pragma===
<nowiki>#</nowiki>pragma это инструкция компилятору, которая определяется реализацией.
Конструкция #pragma в языке Си/Си++ используется для задания дополнительных указаний компилятору. С помощью этих конструкций можно указать как осуществлять выравнивание данных в структурах, запретить выдавать определенныеопределённые предупреждения и так далее.
 
===Замены в тексте===
15

правок