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

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

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

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

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

Типы данных

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

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

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

Операторы сравнения строк нечувствительны к регистру.

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

#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)
```
В показанном выше примере, выражение до первой запятой обрабатывается как оператор следования, тогда как вторая запятая является разделителем параметров.