Директивы
Препроцессорные директивы - это специальные слова, которые указывают компилятору на необходимое поведение в процессе компиляции. Они начинаются с символа $
и заключены в фигурные скобки {}
.
$INCLUDE
Подключает внешний текстовый файл к исходнику. Когда компилятор находит указанную директиву, он открывает файл по пути, переданному в качестве параметра директивы и продолжает компиляцию того кода, который записан во внешнем файле. Когда компилятор достигает конца данного файла, он возвращается обратно в предыдущий файл.
Синтаксис:
Если указан относительный путь, компилятор ищет файл в следующем порядке:
папка, где находится файл, содержащий данную директиву
папка
data
для текущего режима редактированиякорневая папка Sanny Builder
корневая папка игры
Если компилятор не может найти файл относительно ни одной из указанных папок это вызовет ошибку.
Вы можете использовать данную директиву неограниченное число раз. Вкладываемые файлы могут также содержать в себе данную директиву.
$INCLUDE_ONCE
Действует как {$INCLUDE}
с тем единственным отличием, что если файл уже был подключен, он не будет подключен еще раз, и директива будет проигнорирована.
$EXTERNAL
Синтаксис:
$CLEO
Является аналогом директивы $E
, однако полученный файл автоматически копируется в директорию игра\CLEO
, и получает расширение, указанное в директиве.
Синтаксис:
расширение файла
- опциональный параметр, который определяет какое расширение получит скомпилированный файл. Начинается с .
. По умолчанию равен .cs
.
Эта директива предназначена максимально упростить создание CLEO скриптов.
$NOSOURCE
Запрещает компилятору добавлять в конечный файл исходный код скрипта.
Синтаксис:
$OPCODE
Регистрирует новый опкод.
Синтаксис:
либо
либо
путь к файлу с описанием
- директива также принимает путь к файлу в качестве параметра. Этот файл должен содержать в себе только описания опкодов, которые будут загружены компилятором. Если указан относительный путь, компилятор ищет файл по тем же правилам, что и в директиве $INCLUDE
.
Если директива использована без какого-либо параметра, это ведет к загрузке оригинального списка опкодов и отмене всех сделанных изменений.
$USE
Допускается перечисление нескольких имен, разделяемых запятыми.
$VERSION
Эта директива не используется начиная с версии v3.1.0
Синтаксис:
y
- порядок параметров0
- оригинальный, все параметры идут последовательно 0, 1, 2 и т.д.1
- модифицированный порядок, некоторые параметры переставлены
zzzz
- номер ревизии
По умолчанию компилятор загружает версию <текущий режим>.1.0000
$VERSION_RESTORE
Эта директива не используется начиная с версии v3.1.0
Восстанавливает версию, которая использовалась до директивы $VERSION
.
Синтаксис:
Last updated