Переменные

Search…
Переменные
Переменная - это именованная область памяти со значением, которое может быть многократно прочитано и/или изменено. Существует два вида переменных - глобальные и локальные.
Глобальные переменные
Глобальная переменная начинается со знака $, после которого следует ее имя. Имя глобальной переменной может состоять из латинских букв, цифр и _:
$variable1 $100 $____
Глобальная переменная, чье имя состоит из цифр, называетсяDMA-переменная (Direct Memory Address). См. Alloc.
Значения глобальных переменных доступны из любого места в коде.
Сохраняемые переменные
Сохраняемые переменные - это особый вид глобальных переменных, добавленный в LCS и VCS режимах. Перед их именем стоит $_, например $_var. Значение такой переменной восстанавливается при загрузке сохраненной игры. Глобальные переменные, которые начинаются только с $ (например, $var), не сохраняют свое значение и обнуляются при загрузке сохранения в LCS или VCS.
Локальные переменные
Именем локальной переменной служит число, после которого стоит знак @.
1
[email protected] 
2
[email protected] 
3
[email protected]
Copied!
Значения локальных переменных доступны только в пределах текущего скрипта или миссии.
Количество локальных переменных в одном скрипте/миссии строго ограничено.
Переменные-таймеры
Каждый скрипт или миссия также имеют две особые локальные переменные, которые называются TIMERA и TIMERB. Значение переменной-таймера постоянно увеличивается с ходом игры, поэтому они обычно используются, чтобы измерять время, пройденное с определенного момента (сброса таймера).
1
0006: TIMERA = 0 // сброс таймера
2
​
3
:WAIT_2S
4
0001: wait 0 ms
5
00D6: if
6
0019:   TIMERA > 2000 // если таймер увеличился до 2000, т.е. прошло 2 секунды
7
004D: jump_if_false @WAIT_2S
8
0662: printstring "2 seconds has passed" // показать текст
Copied!
Имена TIMERAиTIMERBдоступны начиная с Sanny Builder v3.3.0. В более ранних скриптах таймеры использовались как обычные локальные переменные [email protected], [email protected] (в GTA3 и VC) либо [email protected], [email protected] (SA).
Конструкция VAR..END
Переменные обычно используются в арифметических или условных выражениях. Если в выражении правая часть является числом, опкод указывать не обязательно:
1
$var = 0
2
$myarray($index, 10i) >= 150
Copied!
Если же обе части выражения являются переменными, компилятор не сможет подобрать нужный опкод, т.к. типы переменных неизвестны.
Например, существует два опкода, которые складывают значения двух переменных: 0058 для целых чисел и 0059 для дробных.
1
0058: $Var1 += $Var2 // (целые числа)
2
0059: $Var1 += $Var2 // (дробные числа)
Copied!
Если убрать опкод, как скомпилировать такое выражение?
1
$Var1 += $Var2 // ??
Copied!
Чтобы сообщить компилятору тип переменных, используется конструкция VAR..END.
Конструкция VAR..END позволяет объявлять переменные и их типы.
Синтаксис:
var
<переменная>: <тип>
end
Когда обе переменные имеют объявленный тип, выражение компилируется без опкода:
1
var
2
    $Var1 : Integer
3
    $Var2 : Integer
4
end
5
$Var1 += $Var2 // здесь будет опкод 0058
Copied!
Поддерживаются следующих типы переменных:
Integer, Int - целые числа
Float - дробные числа
String, ShortString - переменная, содержащая короткий строковый литерал (используется только при объявлении массивов, для одиночных переменных используются префикс s$ или суффикс @s)
LongString - переменная, содержащая длинный строковый литерал (используется только при объявлении массивов, для одиночных переменных используются префикс v$ или суффикс @v)
<Имя класса> - переменная или массив переменных членов класса​
Типы локальных переменных также могут быть объявлены.
Как только тип переменной объявлен, он используется везде ниже по коду. Тип переменной может быть изменен, если она используется по-другому:
1
script_name 'Food'
2
var
3
    [email protected] : Float
4
    $Var : Float
5
end
6
$var = 1
7
[email protected] = $Var
8
end_thread
9
​
10
thread 'Loop'
11
var
12
    [email protected] : Int
13
    $Var : Int
14
end
15
$var = 1
16
[email protected] = $Var
17
end_thread
Copied!
В скрипте'Food' [email protected] является дробной переменной. В скрипте'Loop' [email protected] уже целочисленная переменная.
Тип переменной может быть переобъявлен многократно.
Короткая форма объявления переменных
Начиная с версии 3.2.0 можно объявлять переменные, используя только имя типа (доступно для типов Int, Float, String, LongString).
Синтаксис:
<type> <variable name>
1
int [email protected] // [email protected] объявлена как целочисленная переменная
Copied!
Начиная с версии 3.4.0 появилась возможность объявить переменную с собственным именем:
1
int a
2
float distance
3
string name
4
​
5
a = 1
6
distance = 15.5
7
name = 'CJ'
Copied!
Одновременно с объявлением такой переменной можно присвоить ей начальное значение, чтобы уменьшить количество строк кода:
1
int a = 1
2
float distance = 15.5
3
string name = 'CJ'
Copied!
Компилятор связывает каждое имя с новой локальной переменной. В примере выше код будет скомпилирован примерно следующим образом:
1
0006: [email protected] = 1 
2
0007: [email protected] = 15.5 
3
05AA: [email protected] = 'CJ'
Copied!
Из-за архитектурных ограничений эта возможность доступна только в CLEO скриптах.
Начальное значение переменной
Одновременно с объявлением переменной можно задать ей начальное значение. Для этого напишите = и значение:
1
var
2
    $fVar: float = 1.0
3
end
Copied!
или
1
float $fVar = 1.0
Copied!
Теперь переменная $fVar объявлена как Float, и компилятор добавит в скрипт опкод 0005:
1
0005: $fVar = 1.0
Copied!
Инициализация доступна только для переменных, но не массивов.
Синтаксис - Previous
Типы данных
Next - Синтаксис
Константы
Last modified 9mo ago
Copy link
Contents
Глобальные переменные
Сохраняемые переменные
Локальные переменные
Переменные-таймеры
Конструкция VAR..END
Короткая форма объявления переменных
Начальное значение переменной