Процедуры и функции работы с числами

В этом разделе описаны процедуры и функции работы с числами и численными переменными. Численная переменная имеет вид $var и может использоваться вместо параметра в функциях и процедурах. Так же она может выступать как член арифметических операций.

Содержание

• DEFINE
• UNDEFINE
• INC
• RND
• RNDFROM
• INT
• DIST
• SIN
• COS
• ARCSIN
• ARCCOS
• SQRT
• POW
• ABS
• ROUND
• ARRPUSH
• ARRPOP
• ARRSIZE
• SETVAR
• GETVAR

DEFINE

DEFINE ($var, [value]) - объявляет переменную и присваивает ей значение

$var - символьное имя переменной, начинается с $
value - числовое либо строковое значение; необязательный параметр;

DEFINE($myvar, 5)
DEFINE($myvar, 10)
logwrite("Value: ", $myvar)

Инструкция сработает только если переменная не была объявлена раньше. В противном случае инструкция игнорируется
Если параметр value опущен, переменная инициализируется нулем

UNDEFINE

UNDEFINE ($var) - удаляет переменную из памяти

$var - символьное имя переменной

Если обратиться к удаленной переменной, ее значение представится как 0
Стоит понимать, что удаление переменной высвобождает память и в некоторой степени ускоряет последующую работу кликера с переменными

INC

INC ($var, [value]) - увеличивает значение переменной

$var - переменная
value - числовое значение, прибавляемое к переменной; необязательный параметр;

INC($myvar, 5) // увеличивает значение переменной на 5

INC($myvar, -3) // уменьшает значение переменной на 3

Если параметр value не указан, происходит увеличение на 1

RND

RND (a, b) - числовая функция; возвращает целое число, выбранное случайно из заданного интервала

a - нижняя граница интервала
b - верхняя граница интервала

lclick( RND(0,100), RND(0,100) )

Числа a,b входят в выдаваемые функцией значения

RNDFROM

RNDFROM (a, b, ...) - числовая функция; возвращает случайно выбранное число из заданного набора

a, b, ... - набор элементов; число параметров функции неограниченно;

$var = RNDFROM(1,3,5)

INT

INT (num) - числовая функция; возвращает целую часть числа без округления

num - число

$var = int(25.73)
print($var)   // 25

Так же может переводить некоторые строки в числа. Например, строку, содержащую шестнадцатиричное представление числа.
Если вам нужно округлить число до заданной точности, см. функцию ROUND

DIST

DIST (x1, y1, x2, y2) - числовая функция; возвращает расстояние между двумя точками

x1,y1 - координаты одной точки
x2,y2 - координаты второй

$distance = DIST(0,0,3,3)

Функция возвращает результат в виде числа с плавающей точкой

SIN

SIN (arg) - числовая функция; тригонометрический синус

arg - аргумент функции в градусах

// движение мыши по синусоиде
for ($i, $i < 500)
  $y1 = sin($i) * 180 / 3.1415
  move($i*2, int($y1) + 300)
  waitms(100)
end_cyc

COS

COS (arg) - числовая функция; тригонометрический косинус

arg - аргумент функции в градусах

ARCSIN

ARCSIN (arg) - числовая функция; тригонометрический арксинус

arg - аргумент функции

В тригонометрическом смысле, является обратной синусу функцией. Позволяет по известному значению функции синуса получить ее исходный аргумент.

$var = 30
print($var)

$var = sin($var)  // sin(30) = 0.5
print($var)

$var = arcsin($var) // arcsin(0.5) = 30
print($var)

ARCCOS

ARCCOS (arg) - числовая функция; тригонометрический арккосинус

arg - аргумент функции

В тригонометрическом смысле, является обратной косинусу функцией. Позволяет по известному значению функции косинуса получить ее исходный аргумент.

SQRT

SQRT (arg) - числовая функция; квадратный корень

arg - аргумент функции

POW

POW (arg,power) - числовая функция; возведение в степень

arg - число
power - степень

ABS

ABS (arg) - числовая функция; возвращает модуль числа

arg - число

ROUND

ROUND (arg, prec) - числовая функция; округляет число до заданной точности

arg - число
prec - точность

$r = ROUND(1236, 1) // $r = 1240
$r = ROUND(1236, 2) // $r = 1200

$r = ROUND(1.236, -2) // $r = 1.24
$r = ROUND(1.236, -1) // $r = 1.2
$r = ROUND(1.236, 0)  // $r = 1

Округление происходит в сторону от нуля. То есть prec = 2 округлит число до сотен, а prec = -2 до сотых (два знака после точки). Откругление происходит по стандартному правилу 0.5

ARRPUSH

ARRPUSH ($var, value) - добавляет элемент в конец массива

ARRPUSH, ARRPOP и ARRSIZE служат для работы с массивами. Если вы не очень понимаете работу с массивами, рекомендуется ознакомиться со статьей "Массивы" на официальном форуме.

$var - массив
value - число либо строка

arrpush($arr, 435)
arrpush($arr, 532)
arrpush($arr, 943)

print($arr[0])
print($arr[1])
print($arr[2])

ARRPOP

ARRPOP ($var) - числовая функция; извлекает из массива последний элемент

$var - массив

arrpush($arr, 435)
arrpush($arr, 532)
arrpush($arr, 943)

print( arrpop($arr) )
print( arrpop($arr) )
print( arrpop($arr) )

Извлечение подразумевает возвращение значения и удаление элемента из массива

ARRSIZE

ARRSIZE ($var) - числовая функция; возвращает количество элементов в массиве

$var - массив

arrpush($arr, 435)
arrpush($arr, 532)
arrpush($arr, 943)

print( arrsize($arr) )
print( arrpop($arr) )
print( arrsize($arr) )

Не стоит забывать, что индексация массива идет от нуля, поэтому максимально доступный индекс всегда будет arrsize()-1

SETVAR

SETVAR ("$var", value) - присваивает значение переменной по ее имени

$var - строка, содержащая имя переменной
value - присваемое значение

// подпрограмма, умножающая переменную на три
// имя переменной принимается в виде строки
sub(triple, $triple_var)
  $tmp = getvar($triple_var)
  setvar($triple_var, $tmp * 3)
end_sub

// инициализация
$var = 10

// вызов подпрограммы
triple("$var")

// вывод обновленной переменной
print( $var )
halt

К моменту вызова переменная с указанным именем должна существовать

GETVAR

GETVAR ("$var") - функция; возвращает значение переменной по ее имени

$var - строка, содержащая имя переменной

см. SETVAR

К моменту вызова переменная с указанным именем должна существовать