Препроцессор Inno Setup: Синтаксис выражений

ISPP использует C/C++-подобный синтаксис выражений. Он поддерживает простые и составные операторы, условные операторы и операторы следования. И хотя ISPP является всего лишь интерпретатором, но также поддерживает короткие логические операции и никогда не вычисляет выражения (и какие-либо пользовательские функции, упомянутые в этих выражениях), которые по причине особых правил не должны вычисляться (например, при использовании условного оператора будут вычислены только 2 и 3 операнды).

В файле сценария ISPPBuiltins.iss вы найдете множество примеров синтаксических выражений.

Различия между синтаксисом C и ISPP

ISPP не поддерживает работу со следующими операторами: ссылочные, разыменованные, разрешения области видимости, принадлежности и т.д.
ISPP рассматривает идентификатор со знаком равенства в качестве имени параметра, если этот идентификатор используется в списке параметров.
Арифметический оператор деления (косая черта) выполняет только целочисленное деление, т.к. ISPP не поддерживает математические операции с плавающей запятой.
В некоторых случаях ISPP не выполняет проверку правильности выражений. Например, в условном выражении операнд "true" может быть строковым (str) типом данных, в то время как операнд "false" может быть целочисленным (int).
Строковые литералы могут быть заключены как в одинарные кавычки, так и в двойные (в стиле С или Pascal). Если строка открывается одинарной кавычкой, то и закрываться должна также одинарной. Двойные кавычки могут быть использованы внутри одинарных кавычек и наоборот. Если внутри строки необходимо записать часть выражения снова в кавычках (например, цитата), то символы этих кавычек необходимо экранировать (это зависит от текущего состояния параметра "Pascal-стиль строковых литералов" для синтаксического анализа строк сценария, см. директиву pragma). Также смотрите встроенную переменную NewLine.

Типы данных

ISPP содержит три типа данных: void (пустой), integer (целочисленный) и string (строковый). Переменные типа void объявляются директивой define, для которой указывается только имя переменной без каких-либо значений. Такие переменные могут использоваться с директивой ifdef или в функции Defined.

Если для синтаксического анализа строк параметр "Разрешить применение необъявленных идентификаторов" отключен (это состояние по умолчанию, подробности смотрите в pragma), то возникнет ошибка, т.к. компилятор не знает, что это за переменные. В противном случае, они будут обработаны как пустые (тип void), т.е. не имеющие никаких значений.

В выражениях тип void хорошо совместим с целочисленными (int) и строковыми (str) типами данных. Например, вы можете запросто сложить два операнда, один из которых является int, в другой — void. В этом случае пустой операнд будет обработан как ноль (целое число 0). Если же операции выполняются над строками, пустой операнд будет обработан как пустая строка.

Для облегчения чтения и понимания текста сценария, вы можете писать комментарии. Покажем вам основные принципы ввода комментариев и символы, которые при этом можно использовать. Посмотрите на следующий пример, используя косую черту ( / ) и звездочку ( * ) можно внедрить комментарий в выражение:

#emit Var1 /* это комментарий */ + Var2 /* и это тоже комментарий */

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

#emit Var1 + Var2 ; это комментарий
#emit Var1 + Var2 // это тоже комментарий

Если текст комментария очень большой, то используя символ разделения строк — обратная косая черта ( \ ) — его можно разбить на несколько строк. Например:

#emit Var1 + Var2 ; здесь находится текст \
очень длинного комментария :)

Комментарии также можно разместить в любом месте с начала строки, используя двойную косую черту ( // ). Например:

// Это комментарий

Все комментарии, показанные выше, не включаются в данные вывода препроцессора, в отличие от комментариев (не ISPP), использующих точку с запятой в начале строки. Например:

#emit Var1 + Var2 ; этого комментария на выходе препроцессора НЕ будет
// Этого комментария тоже НЕ будет
; А вот этот комментарий БУДЕТ

Расширенный синтаксис вызова пользовательских функций

В ISPP имеется возможность использования именованных параметров при вызове функций, определённых пользователем. Например, выполним объявление функции MyFunction:

#define MyFunction(int A = 2, int B = 2) A + B

Теперь выполним вызов этой функции и укажем имена параметров:

#emit MyFunction(A = 5, B = 10)
#emit MyFunction(B = 3)
#emit MyFunction(B = 10, A = 5)

Если хотя бы для одного параметра задано имя, то и все остальные параметры (обязательно!) в списке также должны иметь имена.
Порядок размещения именованных параметров не имеет значения.
Если расширенный синтаксис вызова не используется, то чтобы избежать двусмысленности, операция присваивания должна быть заключена в круглые скобки:
```
#emit MyFunction((MyVar = 5), 10)
```
В этом примере знак равенства рассматривается как оператор присваивания.
Хотя функции и не имеют именованных параметров, все же, при их вызове, рекомендуется заключить выражения в круглые скобки.
Согласно стандартным правилам, для разделения фактических параметров используется запятая ( , ). Если вам необходимо использовать оператор следования, то вы должны заключить его в круглые скобки. Например:
```
#emit MyFunction((SaveToFile("script.txt"), 5), 10)
```
В показанном выше примере, выражение до первой запятой обрабатывается как оператор следования, тогда как вторая запятая является разделителем параметров.