Документация QSP
Сайт Форум

Эта страница только для чтения. Вы можете посмотреть исходный текст, но не можете его изменить. Сообщите администратору, если считаете, что это неправильно.
[[help:variables|Назад: Переменные]]

====== Выражения ======


**Выражение** - это набор значений, констант, переменных, функций, связанных между собой различными операциями. Программа выполняет (интерпретирует) такое выражение, вычисляя его значение.

Для изменения приоритета операций в выражении могут присутствовать круглые скобки.

===== Обозначения =====


	*  ''[выр]'' - выражение может быть как текстового, так и числового типа.
	*  ''[$выр]'' - выражение текстового (строкового) типа (но при необходимости движок автоматически переведёт число в строку).
	*  ''[#выр]'' - выражение числового типа (если возможно, движок автоматически переведёт строку в число).

**Примечение.** Символ ''**#**'' использован в справке только чтобы разделить выражения произвольного и числового типов. К синтаксису QSP данный символ отношения не имеет.

===== Приоритет операций =====


Операции в выражении выполняются в порядке приоритета. Операции с одинаковым приоритетом выполняются по порядку слева направо.

Вот список операций для плееров **QSP** версии 5.8.0 в порядке повышения приоритета (от меньшего к большему): 

	* ''**OR**''
	* ''**AND**''
	* ''**NO**''
	* ''**=**'', ''**<**'', ''**>**'', ''**!**'', ''**<>**'', ''**%%<=%%**'', ''**>=**'', ''**=<**'', ''**%%=>%%**'' (операции сравнения)
	* ''**OBJ**'', ''**LOC**''
	* ''**&**'' (конкатенация)
	* ''**+**'', ''**-**'' (сложение, вычитание)
	* ''**MOD**''
	* ''*****'', ''**/**'' (умножение, деление)
	* ''**-**'' (унарный минус)
	* ''**(**[выр]**)**'' - выражения в скобках
	
Выражения в **QSP** должны удовлетворять следующим условиям:

	*  Максимальная вложенность выражений - 30. Т.е. не глубже 30-ти открытых и вложенных друг в друга скобок.
	*  Максимальное количество операций на одном уровне вложенности - 100.

===== Описание операций =====


**Важно!** Поскольку в **QSP** нет булевого типа данных, истинность или ложность выражения определяется по его числовому значению. Верным считается числовое выражение, значение которого отлично от ''**0**''. При значении ''**0**'' выражение считается ложным. Для значения "верно" настоятельно рекомендуется использовать число ''**1**'', т.к. операции сравнения и логические операции возращают именно это значение в случае истинности выражения.

==== Математические операции ====

	*  ''**-**[#выр]'' - унарный минус. Можно поставить перед числовым выражением и таким образом поменять знак этого выражения на противопложный:<sxh qsp>
		x = -12
		*pl -x & ! выведет на экран число 12
		*pl -(123*12/-10)
		*pl -10/-5
</sxh>
		*  ''**+**'' , ''**-**'' , ''*****'', ''**/**'' - сложение, вычитание, умножение, деление соответственно.\\ Операции записываются как ''**[#выр1] [операция] [#выр2]**'':<sxh qsp>
		15+2*5 &! 15+2*5 = 15+10 = 25
		15*2+5 &! 15*2+5 = 30+5 = 25
		15*5/2 &! (15*5)/2 = 75/2 = 37
		15/2*5 &! (15/2)*5 = 7*5 = 35
</sxh>
	*  ''[#выр1] **MOD** [#выр2]'' - остаток от деления. Это операция, которой нас учат ещё в начальной школе. Если мы вычисляем, сколько раз число делится нацело на другое число, то в результате может остаться некая неучтённая часть. Например, если мы хотим разделить **10** на **3**, то число **10** нацело делится на **3** только три раза. Но **3** умножить на **3** - это **9**. Значит, от десяти осталась часть, которая не делится на **3**, это **1** (**10 - 9 = 1**). Эта часть и называется остатком от деления. Для числа **12** остаток от деления на **3** составляет ноль, поскольку двенадцать делится на **3** ровно четыре раза. Примеры:<sxh qsp>
		10 mod 2 & ! 10/2 = 5 -> 2*5=10 -> 10-10 = 0 -> остаток от деления 10 на 2 равен 0
		10 mod 3 & ! 10/3 = 3 -> 3*3=9  -> 10-9 = 1  -> остаток от деления 10 на 3 равен 1
		10 mod 4 & ! 10/4 = 2 -> 4*2=8  -> 10-8 = 2  -> остаток от деления 10 на 4 равен 2
		10 mod 5 & ! 10/5 = 2 -> 5*2=10 -> 10-10 = 0 -> остаток от деления 10 на 5 равен 0
		10 mod 6 & ! 10/6 = 1 -> 6*1=6  -> 10-6 = 4  -> остаток от деления 10 на 6 равен 4
		10 mod 7 & ! 10/7 = 1 -> 7*1=7  -> 10-7 = 3  -> остаток от деления 10 на 7 равен 3
		
</sxh>

==== Операции сравнения ====

	*  ''[выр1] **=** [выр2]'' - операция **равно**. Верно, если значения рядом стоящих выражений равны. Данную операцию не стоит путать с операцией присваивания, хотя на первый взгляд они похожи. Чтобы операция **равно** корректно вернула значение, она должна быть записана после ключевого слова ''**IF**'', ''**ELSEIF**'', ''**WHILE**'' или в первом аргументе функции ''**IIF**'', или стоять после явного оператора вывода текста вроде ''***PL**'', или если используется с неявным оператором, быть заключённой в скобки. Примеры:<sxh qsp>
		! операция сравнения **равно** с явным указанием оператора перед ней:
		*pl 6+12 = 6*3 & ! 6+12 = 6*3 -> 18=18 -> на экране мы увидим число 1, что означает, что значения выражений равны
		*pl 226 = 15*15 & ! 226 = 15*15 -> 226=225 -> на экране увидим **0**, так как 226 не равно 225.
		! операция сравнения **равно** с неявным оператором
		('ab'+'cd' = 'abc'+'d') & ! на экране увидим 1, так как 'ab'+'cd' равно 'abc'+'d'
		(13*9 = 19*3) & ! на экране увидим 0, так как 13*9 не равно 19*3
		! операция сравнения в условии
		if x = y:
			*pl "Числа равны"
		else
			*pl "Числа не равны"
		end

</sxh>
	*  ''[выр1] **<** [выр2]'' - операция **меньше**. Верно, если значение выражения слева меньше значения выражения справа.<sxh qsp>
		*pl 37<56 & ! на экране будет число 1, так как 37 меньше 56
		*pl 45<23 & ! на экране будет число 0, так как 45 не меньше 23
		*pl 45<45 & ! на экране будет число 0, так как 45 не меньше 45

		if x < y:
			"X меньше Y"
		elseif y < x:
			"Y меньше X"
		else
			"Числа равны"
		end
</sxh>
	*  ''[выр1] **>** [выр2]'' - операция **больше**. Верно, если значение выражения слева больше значения выражения справа.<sxh qsp>
		*pl 37>56 & ! на экране будет число 0, так как 37 не больше 56
		*pl 45>23 & ! на экране будет число 1, так как 45 больше 23
		*pl 45>45 & ! на экране будет число 0, так как 45 не больше 45

		if x > y:
			"X больше Y"
		elseif y > x:
			"Y больше X"
		else
			"Числа равны"
		end
</sxh>
	*  ''[выр1] **!** [выр2], [выр1] **<>** [выр2]'' - операция **не равно**. Верно, если значения рядом стоящих выражений не равны.<sxh qsp>
		! операция сравнения **равно** с явным указанием оператора перед ней:
		*pl 6+12 ! 6*3 & ! 6+12 = 6*3 -> 18=18 -> на экране мы увидим число 0, что означает, что значения выражений не равны
		*pl 226 ! 15*15 & ! 226 = 15*15 -> 226=225 -> на экране увидим **1**, так как **226** не равно **225**.
		! операция сравнения **равно** с неявным оператором
		*pl 'ab'+'cd' <> 'abc'+'d' & ! на экране увидим 0, так как 'ab'+'cd' равно 'abc'+'d'
		*pl 13*9 <> 19*3 & ! на экране увидим 1, так как 13*9 равно 19*3
		! операция сравнения в условии
		if x <> y:
			*pl "Числа не равны"
		else
			*pl "Числа равны"
		end

</sxh>		**Примечание.** Во избежание путаницы с оператором комментария ''**!**'' лучше не использовать для записи операции **не равно** восклицательный знак.
	*  ''[выр1] **%%<=%%** [выр2], [выр1] **=<** [выр2]'' - операция **меньше либо равно**. Верно, если значение выражения слева меньше или равно значению выражения справа.<sxh qsp>
		*pl 37<=56 & ! на экране будет число 1, так как 37 меньше 56
		*pl 45<=23 & ! на экране будет число 0, так как 45 не меньше и не равно 23
		*pl 45<=45 & ! на экране будет число 1, так как 45 равно 45

		if x <= y:
			"X меньше либо равно Y"
		else
			"Y меньше X"
		end

</sxh>		**Примечание.** Запись ''**%%=>%%**'' редко применяется в других языках программирования, поэтому рекомендуем не привыкать к её использованию, хотя в **QSP** это ошибкой не будет.
	*  ''[выр1] **>=** [выр2], [выр1] **%%=>%%** [выр2]'' - операция **больше либо равно**. Верно, если значение выражения слева больше или равно значению выражения справа.<sxh qsp>
		*pl 37>=56 & ! на экране будет число 0, так как 37 не больше и не равно 56
		*pl 45>=23 & ! на экране будет число 1, так как 45 больше 23
		*pl 45>=45 & ! на экране будет число 1, так как 45 равно 45

		if x >= y:
			"X больше либо равно Y"
		else
			"Y больше X"
		end

</sxh>		**Примечание.** Запись ''**%%=>%%**'' редко применяется в других языках программирования, поэтому рекомендуем не привыкать к её использованию, хотя в **QSP** это ошибкой не будет.

==== Логические операции ====

	*  ''**OBJ** [$выр]'' - операция проверки наличия предмета в **Инвентаре**. Верно, если в **Окне предметов** есть предмет с названием ''[$выр]''.<sxh qsp>
		addobj "Отвёртка"

		*pl obj "Отвёртка" & ! на экране будет число 1, так как предмет **Отвёртка** есть в окне предметов
		*pl obj "Апельсин" &! на экране будет число 0, так как предмета **Апельсин** нет в окне предметов

		if obj "Отвёртка":
			*pl "У вас есть отвёртка."
		else
			*pl "У вас нет отвёртки."
		end

</sxh>
	*  ''**LOC** [$выр]'' - операция проверки наличия локации в игре. Верно, если в игре есть локация с названием ''[$выр]''.<sxh qsp>
		! в игре создана локация "Густая чаща"
		*pl loc "Густая чаща" & ! на экране мы увидим число 1

		if loc "Дом":
			*pl "Вы можете войти в дом."
		else
			*pl "Вы не можете войти в дом."
		end
</sxh>
	*  ''**NO** [#выр]'' - операция отрицания, логическое отрицание, или логическая инверсия. Если ''[#выр]'' верно, операция возвращает **0**, а если ''[#выр]'' не верно, операция возвращает **1**. Примеры:<sxh qsp>
		*pl no 1 & ! на экране увидим 0, так как 1 соответвует верному выражению
		*pl no 7 & ! на экране увидим 0, так как 7 соответвует верному выражению
		*pl no 0 & ! на экране увидим 1, так как 0 соответствует неверному выражению

		addobj "Отвёртка"
		if no obj "Отвёртка":
			"У вас нет отвёртки."
		else
			"У вас есть отвёртка."
		end

</sxh>
	*  ''[#выр1] **OR** [#выр2]'' - операция логического "или". Всё выражение верно, если хотя бы одна из его частей верна: ''[#выр1]'' или ''[#выр2]''. Примеры:<sxh qsp>
		*pl 1 or 1 & ! на экране увидим 1, так как обе части выражения равны 1
		*pl 1 or 0 & ! на экране увидим 1, так как левая часть равна 1
		*pl 0 or 1 & ! на экране увидим 1, так как правая часть равна 1
		*pl 0 or 0 & ! на экране увидим 0, так как обе части выражения равны 0

		! обе части выражения верны, значит и всё выражение верно
		(2=2) or (3<>2) & ! выражение вернёт 1 (правда)
		! одна часть выражения верна, значит всё выражение верно
		(2<>2) or (3<>2) & ! выражение вернёт 1 (правда)
		! обе части выражения не верны, значит и всё выражение не верно
		(2<>2) or (3=2) & ! выражение вернёт 0 (ложь) 
</sxh>Если ''[#выр1]'' верно, значение ''[#выр2]'' не вычисляется.
	*  ''[#выр1] **AND** [#выр2]'' - операция побитового "и". Всё выражение верно, только если обе его части верны: и ''[#выр1]'', и ''[#выр2]''. Примеры:<sxh qsp>
		*pl 1 and 1 & ! на экране увидим 1, так как обе части выражения равны 1
		*pl 1 and 0 & ! на экране увидим 0, так как только левая часть равна 1
		*pl 0 and 1 & ! на экране увидим 0, так как только правая часть равна 1
		*pl 0 and 0 & ! на экране увидим 0, так как обе части выражения равны 0

		! обе части выражения верны, значит и всё выражение верно
		(2=2) and (3<>2) & ! выражение вернёт 1 (правда)
		! одна часть выражения не верна, значит всё выражение неверно
		(2<>2) and (3<>2) & ! выражение вернёт 0 (ложь)
		! обе части выражения не верны, значит и всё выражение не верно
		(2<>2) and (3=2) & ! выражение вернёт 0 (ложь)
</sxh>		Если ''[#выр1]'' не верно, значение ''[#выр2]'' не вычисляется.

==== Операции со строками ====

	*  ''[$выр1] **&** [$выр2]'' - операция объединения строковых выражений. Подробнее см. [[help:strings|Строки]]. Не путайте с символом перечисления команд. Примеры:<sxh qsp>
		! в данном случае на экран будут последовательно выведены строки "26" и "27"
		"26" & "27"
		! в данном случае на экран будет выведена строка "2627"
		("26" & "27")

</sxh>		Во избежание путаницы, для объединения строк используйте операцию ''**+**'', она работает точно так же.
	*  ''[$выр1] **+** [$выр2]'' - операция объединения строковых выражений. Подробнее см. [[help:strings|Строки]]. Примеры:<sxh qsp>
		! в данном случае на экран будет выведена строка "2627"
		"26" + "27"
</sxh>

===== Другие примеры =====


<sxh qsp>
x=5
y=6
(x ! y) OR (x <> y)	&! Результат 1
x OR y			&! Результат 1
x AND y 		&! Результат 1
y MOD x			&! 6/5 -> остаток 1 Результат 1
OBJ 'стул'		&! Если в инвентаре есть предмет 'стул', то результат 1, если нет, то 0
LOC 'дом'		&! Если в игре есть локация 'дом', то результат 1, если нет, то 0
res = x*y + y*-x/2	&! (5*6) + (6*(-5)/2)=15  -> в res запишется число 15
res = NO x = y		&! NO 5 = 6 -> NO 0 -> в res запишется число 1

</sxh>

===== Операции с присваиванием =====
[:sokraschennye_operacii_s_prisvoeniem]

Помимо обыкновенной [[help:variables|операции присваивания]] в **QSP** существуют так же совмещённые математические операции с присваиванием.

	* ''**+=**'' — операция "сложение с присваиванием", сочетающая в себе операции присваивания и сложения. Прибавляет к текущему значению переменной указанное значение. Общая запись:<sxh qsp>
			имя_переменной+=[выражение]
</sxh>		Эквивалентно конструкции:<sxh qsp>
			имя_переменной=имя имя_переменной+[выражение]
</sxh>		Пример:<sxh qsp>
		! мы заменяем две операции: присвоения и сложения
		warrior=warrior+15
		! на одну (действие аналогично)
		warrior+=15
</sxh>		Примечание: данную операцию можно использовать и для склейки строк. При этом строка "приклеивается в конец уже существующей строки":<sxh qsp>
		$text='Вечное слово в остывшей'
		$text+=' золе...'
</sxh>
	* ''**-=**'' — операция "вычитание с присваиванием", сочетающая в себе операции присваивания и вычитания. Вычитает из текущего значения переменной указанное значение. Общая запись:<sxh qsp>
			имя_переменной-=[#выражение]
</sxh>		Эквивалентно конструкции:<sxh qsp>
			имя_переменной=имя имя_переменной-[#выражение]
</sxh>		Пример:<sxh qsp>
		! мы заменяем две операции: присвоения и вычитания
		warrior=warrior-15
		! на одну (действие аналогично)
		warrior-=15
</sxh>
	* ''**/=**'' — операция "деление с присваиванием", сочетающая в себе операции присваивания и деления. Делит текущее значение переменной на указанное значение. Общая запись:<sxh qsp>
			имя_переменной/=[#выражение]
</sxh>		Эквивалентно конструкции:<sxh qsp>
			имя_переменной=имя имя_переменной/[#выражение]
</sxh>		Пример:<sxh qsp>
		! мы заменяем две операции: присвоения и деления
		warrior=warrior/2
		! на одну (действие аналогично)
		warrior/=2
</sxh>
	* ''***=**'' — операция "умножение с присваиванием", сочетающая в себе операции присваивания и умножения. Умножает текущее значение переменной на указанное значение. Общая запись:<sxh qsp>
			имя_переменной*=[#выражение]
</sxh>		Эквивалентно конструкции:<sxh qsp>
			имя_переменной=имя имя_переменной*[#выражение]
</sxh>		Пример:<sxh qsp>
		! мы заменяем две операции: присвоения и умножения
		warrior=warrior*2
		! на одну (действие аналогично)
		warrior*=2
</sxh>

[[help:coding|Вперёд: Программный код]]
Документация QSPСайтФорум

Инструменты пользователя

Инструменты сайта

Инструменты страницы

Документация QSP
Сайт Форум
