Sanny Builder
На русском
Search
K

Типы данных

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

Переменные

Если перед именем переменной (комбинация букв, цифр, и _) стоит знак $ - это глобальная переменная.
0004: $MyVar = 100
Именем локальной переменной может быть только число, после которого стоит @. Это число является индексом в списке локальных переменных, выделенных для текущего скрипта или миссии.
0006: 100@ = 10
Переменная ADMA (Advanced Direct Memory Access, усовершенствованный доступ к памяти) - это указатель на определенный адрес внутри файла main.scm. Они используются так же как глобальные переменные, но в отличие от них ADMA могут читать и писать значения по любому адресу в пределах main.scm.
$myVar = &0 // прочитать первые 4 байта main.scm и записать значение в $myVar
&57 += &120(&231,4i) // также могут использоваться как элементы массива
ADMA переменные не влияют на размер буфера для глобальных переменных, выделенного в заголовке main.scm.

Метки

Метки указывают на определенную строку кода и используются в условных (опкод 004D) и безусловных переходах (опкоды 0002, 0050). Имя метки состоит из букв, цифр и _ и всегда начинается с :
:MyLabel
Чтобы использовать такую метку в опкоде замените : на @
0002: jump @MyLabel
Если имя метки написано как самостоятельное выражение с парой скобок в конце, это представляет собой вызов подпрограммы командой gosub:
// следующие выражения эквивалентны
MyLabel()
gosub @MyLabel

Строковые литералы

Текст, обрамленный одинарными кавычками ' ', - это короткий строковый литерал (до 15 символов).
03A4: script_name 'MAIN'
Текст, обрамленный двойными кавычками " ", - это длинный строковый литерал (максимальная длина определяется опкодом).
Если внутри литерала используется кавычка, она должна быть заэкранирована при помощи обратного слэша\
0662: write_debug_message "Hello, \"world\"! \n 'Here we go!'"
Допускается использование пустых строк '' или "".

Строковые переменные

Глобальные переменные, содержащие короткий строковый литерал, начинаются с s$.
05A9: s$MyString = 'GLOBAL'
Локальные переменные, содержащие короткий строковый литерал, заканчиваются на @s.
05AA: 1@s = 'LOCAL'
Глобальные переменные, содержащие длинный строковый литерал, начинаются с v$.
06D1: v$MyString = "LONG_GLOBAL"
Локальные переменные, содержащие длинный строковый литерал, заканчиваются на @v.
06D2: 1@v = "LONG_LOCAL"

Имена моделей

Вместо ID моделей из .ide файлов могут использоваться их имена, перед которыми стоит #
0247: request_model #CELLPHONE

Числа в 16-ричном формате

0x - число в шестнадцатиричном формате -0x - отрицательное число в шестнадцатиричном формате
0004: $var = -0xBB08
Разрешенный диапазон шестнадцатиричных чисел лежит между -80000000 и 7FFFFFFF.