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

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

=====Программный код=====

  * В QSP нет таких разделителей команд, как ';' в Паскале. Команды разделяются переносом строки или знаком '**&**':<sxh qsp>i=0
j=0</sxh> равнозначно <sxh qsp>i=0 & j=0</sxh>
  * Перед интерпретированием строки удаляются пробелы и символы табуляции в её начале, поэтому можно форматировать код:<sxh qsp>
if яблоки=0 :
    ADDOBJ 'Яблоко'
    яблоки=1
end
</sxh>
  * Иногда бывает удобно разбить строку на несколько. Чтобы следующая строка считалась частью текущей, нужно в конце строки дописать **' _'** (пробел и символ подчёркивания):<sxh qsp>
if a<5 and n-b>4+5+h/7*2 or t=4: p 'TTTTTTTTT' & cla & $f='Text Variable' & goto 'FFFF'
</sxh> равнозначно <sxh qsp>
if a<5 and n-b> _
    4+5+h/7*2 or  _
    t=4: p 'TTTTTTTTT' _
  & cla & $f='Text Variable' _
  & goto 'FFFF'
</sxh>
    * Группа строк, разделённых " _", считается **//одной//** строкой (сообщения об ошибках также выводятся с учётом того, что это одна строка).
    * После **OR** стоит не один, а **//два//** пробела - один пробел расходуется на " _" и получилось бы "ort=4" вмето "or t=4".
      * Исправлено: в более новых версиях (//Quest Navigator//, возможно даже в //AeorQSP//) пробел сохраняется.

====Комментарии====

Для пояснений в коде удобно использовать комментарии, которые игнорируются интерпретатором (плеером):
<sxh qsp>
  !Однострочный комментарий
  яблоки = 0
!'Многострочный
комментарий'
яблоки = 1
  сыр = 5 &  ! А здесь"комментарий начинается
  в той же строке, но" заканчивается 'сильно
  позже'. Во всём виноваты {кавычки и скобки
  }Кстати:
  яблоки=0
 !'Комментарии рекомендуется писать всё-таки
в отдельных строках, а не как с "сыром"'
</sxh>

**Примечание:** при выводе ошибок многострочные комментарии считаются интерпретатором за одну строку.

====Функции====
Функция - ключевое слово, выполняющее какое-либо действие, учитывая свои аргументы (параметры) и возвращающее результат. Аргументы функций задаются выражениями.

Пример вызова функции:
MAX(1,2,4)
Здесь "MAX" - название функции, а 1, 2 и 4 - аргументы функции.
При вызове функций без аргументов или с одним аргументом скобки можно не записывать:
A=RAND 4
B=COUNTOBJ
Перед функциями, которые могут возвращать строковые значения, можно ставить символ "$". Т.е, к примеру, можно написать "pl str(43)" или "pl $str(43)".
Эта возможность настоятельно рекомендуется к использованию, так как улучшает читаемость кода.

Базовые функции языка QSP
CURLOC - возвращает название текущей локации.
RAND([#выражение 1],[#выражение 2]) - возвращает случайное число между числами [#выражение 1] и [#выражение 2]. Параметр [#выражение 2] может отсутствовать, при этом он принимается равным 0.
RND - возвращает случайное значение от 1 до 1000.
MAX([выражение 1],[выражение 2], ...) - возвращает максимальное из значений выражений-аргументов. Если передан один аргумент, то считается, что указано имя массива - в этом случае поиск максимального элемента происходит среди строковых (если название массива указано со знаком "$") или среди числовых значений элементов массива. Например:
MAX(1,2,5,2,0) - вернёт 5
MAX(a,b,c) - вернёт максимальное из значений переменных
MAX('aa','ab','zz') - вернёт 'zz'
MAX('a') - вернёт максимальное из числовых значений элементов массива "A"
MAX('$b') - вернёт максимальное из строковых значений элементов массива "B"

MIN([выражение 1],[выражение 2], ...) - возвращает минимальное из значений выражений-аргументов. Если передан один аргумент, то считается, что указано имя массива - в этом случае поиск минимального элемента происходит среди строковых (если название массива указано со знаком "$") или среди числовых значений элементов массива.
IIF([#выражение],[выражение_да],[выражение_нет]) - возвращает значение выражения [выражение_да], если [#выражение] верно, иначе значение выражения [выражение_нет].

QSPVER - возвращает версию интерпретатора в формате "X.Y.Z".
FUNC([$выражение],[параметр 1],[параметр 2], ...) - обработка локации с названием [$выражение]. Указанные параметры передаются в массиве ARGS. Результат функции равен значению $RESULT при возврате строкового значения или RESULT при возврате числового значения. Если при обработке локации были установлены и RESULT, и $RESULT, то предпочтение отдаётся строковому значению. После обработки локации предыдущие значения ARGS и RESULT восстанавливаются. Примеры:
PL 4 + FUNC('функция') - обработка локации "функция" как функции. Массив ARGS пуст. Результат передается через $RESULT или RESULT, в зависимости от кода обрабатываемой локации.
PL FUNC($name, 1) * 78 - обработка локации с названием в $name как функции. ARGS[0] равен 1.
MSG "text" + FUNC($name, "строка", 2) - обработка локации с названием в $name как функции. $ARGS[0] содержит строку "строка", ARGS[1] равен 2.
DYNEVAL([$выражение],[параметр 1],[параметр 2], ...) - возвращает значение указанного выражения. Функция позволяет вычислять значения динамически сгенерированных выражений. Указанные параметры передаются в массиве ARGS, а после вычисления выражения предыдущие значения ARGS восстанавливаются. Примеры:
DYNEVAL('3+4')
PL DYNEVAL('mid("abcd",2,1)+"qwerty"')
PL DYNEVAL($test + ' + val("<<$test>>")')
проход=DYNEVAL(" $args[0] <> 'текст' ", 'строка')

====Операторы====
Оператор - ключевое слово, выполняющее какое-либо действие. Оператор может иметь аргументы (параметры), необходимые для выполнения. Аргументы операторов задаются выражениями. Операторы не возвращают результат выполнения.
Пример вызова оператора:
ADDOBJ 'ключ','pics/key.png'
Здесь "ADDOBJ" - название оператора, а 'ключ' и 'pics/key.png' - аргументы оператора.
Вызов оператора также может быть записан со скобками:
ADDOBJ ('ключ','pics/key.png')
PL ('текст')
CLEAR()

Базовые операторы языка QSP

DYNAMIC [$строка кода],[параметр 1],[параметр 2], ... - выполнение кода. Данный оператор позволяет динамически генерировать код игры. Переданные параметры хранятся в массиве ARGS. После выполнения кода предыдущие значения ARGS восстанавливаются. Примеры:

DYNAMIC '$a="string<<$b>>"'
DYNAMIC '$a'
DYNAMIC 'if $a="string":''text!'''
DYNAMIC "
$args[0]
addobj $args[1]
",'Текст','Вилка'

----
Вперёд:
Документация QSPСайтФорум

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

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

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

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