Предварительная обработка файла makefile

  • Статья

Вы можете управлять сеансом NMAKE с помощью директив и выражений предварительной обработки. Инструкции по предварительной обработке можно поместить в файл makefile или в Tools.ini. С помощью директив можно условно обработать файл makefile, отобразить сообщения об ошибках, включить другие файлы makefile, отменить макрос и включить или отключить определенные параметры.

Директивы предварительной обработки файла Makefile

Директивы предварительной обработки не учитывает регистр. Начальная восклицательный знак (!) должна отображаться в начале строки. Ноль или несколько пробелов или вкладок могут отображаться после восклицательного знака для отступа.

  • !CMDSWITCHES{+option option- | } ...

    Включает или отключает каждый указанный параметр . Пробелы или вкладки должны отображаться перед оператором или - оператором+. Пробелы не могут отображаться между оператором и буквами параметров. Буквы не учитывает регистр и указываются без косой черты (/). Чтобы включить некоторые параметры и отключить другие, используйте отдельные спецификации !CMDSWITCHES.

    Только /D, /I/Nи /S может использоваться в файле makefile. Во Tools.iniвсех параметрах разрешены, кроме /F, /HELP, /NOLOGO, /Xи /?. Изменения, указанные в блоке описания, не вступают в силу до следующего блока описания. Эта директива обновляется MAKEFLAGS; изменения наследуются во время рекурсии, если MAKEFLAGS задано.

  • !ERRORtext

    Отображает текст в ошибке U1050, а затем останавливает NMAKE, даже если /I!CMDSWITCHES/K.IGNOREиспользуется модификатор тире или тире ().- Пробелы или вкладки перед тем, как текст игнорируется.

  • !MESSAGEtext

    Отображает текст в стандартные выходные данные. Пробелы или вкладки перед тем, как текст игнорируется.

  • !INCLUDE[ ] <имя файла [ ] >

    Считывает имя файла в виде файла makefile, а затем продолжается с текущим файлом makefile. NMAKE сначала ищет имя файла в указанном или текущем каталоге, а затем рекурсивно через каталоги любого родительского файла makefile, а затем, если имя файла заключено угловыми скобками (< >), в каталогах, указанных макросом, которое изначально задается INCLUDE переменной INCLUDE среды. Полезно передать .SUFFIXES параметры и .PRECIOUSправила вывода для рекурсивных файлов makefile.

  • !IFconstant_expression

    Обрабатывает операторы между !IF и следующими !ELSE или !ENDIF если constant_expression оценивается как ненулевое значение.

  • !IFDEFmacro_name

    Обрабатывает операторы между !IFDEF и следующими !ELSE или !ENDIF если macro_name определены. Макрос NULL считается определенным.

  • !IFNDEFmacro_name

    Обрабатывает операторы между !IFNDEF и следующими !ELSE или !ENDIF если macro_name не определены.

  • !ELSE[ IFconstant_expressionIFDEF | macro_name | IFNDEFmacro_name ]

    Обрабатывает операторы между !ELSE и следующими!ENDIF, если предыдущий !IFDEF!IFоператор или !IFNDEF оператор оценивается до нуля. Необязательные ключевое слово дают дополнительный контроль над предварительной обработкой.

  • !ELSEIF

    Является синонимом элемента !ELSE IF

  • !ELSEIFDEF

    Является синонимом элемента !ELSE IFDEF

  • !ELSEIFNDEF

    Является синонимом элемента !ELSE IFNDEF

  • !ENDIF

    Помечает конец !IFили !IFDEF!IFNDEF блок. Любой текст после !ENDIF того же строки игнорируется.

  • !UNDEFmacro_name

    Не определено macro_name.

Выражения в предварительной обработке файла makefile

Или !IF!ELSE IFconstant_expression состоят из целых констант (в нотации десятичного или C-языка), строковых констант или команд. Используйте скобки для группирования выражений. Выражения используют арифметические целочисленные строки C; числа находятся в 32-разрядной двухфакторной форме в диапазоне -2147483648 до 2147483647.

Выражения могут использовать операторы, которые действуют на константных значениях, коды выхода из команд, строк, макросов и путей к файловой системе.

Операторы предварительной обработки файла Makefile

В выражениях предварительной обработки файлов makefile могут использоваться операторы, выполняющие действия с константными значениями, кодами завершения команд, строками, макросами и путями файловой системы. Чтобы оценить выражение, препроцессор сначала развертывает макросы, а затем выполняет команды, а затем выполняет операции. Он оценивает операции в порядке явной группировки в скобках, а затем в порядке приоритета оператора. Результатом является константное значение.

Оператор DEFINED является логическим оператором, который действует в имени макроса. Выражение DEFINED( macro_name ) имеет значение true, если macro_name определен, даже если оно не имеет назначенного значения. DEFINED в сочетании с !IF или !ELSE IF эквивалентен или эквивалентен !IFDEF или !ELSE IFDEF. Однако в отличие от этих директив, DEFINED можно использовать в сложных выражениях.

Оператор EXIST является логическим оператором, который действует на пути к файловой системе. EXIST( path ) значение true, если путь существует. Результат EXIST можно использовать в двоичных выражениях. Если путь содержит пробелы, заключите его в двойные кавычки.

Чтобы сравнить две строки, используйте оператор равенства (==) или оператор неравенства (!=). Строки заключаются в двойные кавычки.

Целые константы могут использовать унарные операторы для числового отрицания (-), дополнения одного (~) и логического отрицания (!).

В выражениях могут использоваться следующие операторы. Операторы с одинаковым приоритетом объединяются в группы, которые перечисляются в порядке убывания приоритета. Унарные операторы связываются с операндом справа. Бинарные операторы одинакового приоритета связывают операнды слева направо.

Operator Description
DEFINED(macro_name) Создает логическое значение для текущего состояния определения macro_name.
EXIST(path) Создает логическое значение для существования файла по пути.
! Унарное логическое НЕ.
~ Унарное дополнение.
- Унарное отрицание.
* Умножение.
/ Деление.
% Модуль (остаток от деления).
+ Сложение.
- Вычитание.
<< Побитовое смещение влево.
>> Побитовое смещение вправо.
<= Меньше или равно.
>= Больше или равно.
< Меньше.
> Больше чем.
== Равенство.
!= Неравенство.
& Битовый AND.
^ Битовый XOR.
| Битовый OR.
&& Логический оператор AND.
|| Логический оператор OR.

Примечание.

Побитовый оператор XOR (^) совпадает с символом escape- и должен быть экранирован (как ^^) при использовании в выражении.

Выполнение программы при предварительной обработке

Чтобы использовать код выхода команды во время предварительной обработки, укажите команду с любыми аргументами в скобках ([ ]). Все макросы развертываются перед выполнением команды. NMAKE заменяет спецификацию команды кодом выхода команды, который можно использовать в выражении для управления предварительной обработкой.

Пример

!IF [my_command.exe arg1 arg2] != 0
!MESSAGE my_command.exe failed!
!ENDIF

См. также

Справочник по NMAKE