Документация QSP

СайтФорум

• В QSP нет таких разделителей команд, как ';' в Паскале. Команды разделяются переносом строки или знаком '&':

  i=0
  j=0

  равнозначно

  i=0 & j=0

• Перед интерпретированием строки удаляются пробелы и символы табуляции в её начале, поэтому можно форматировать код:

  if яблоки=0 :
      ADDOBJ 'Яблоко'
      яблоки=1
  end
  

• Иногда бывает удобно разбить строку на несколько. Чтобы следующая строка считалась частью текущей, нужно в конце строки дописать ' _' (пробел и символ подчёркивания):

  if a<5 and n-b>4+5+h/7*2 or t=4: p 'TTTTTTTTT' & cla & $f='Text Variable' & goto 'FFFF'
  

  равнозначно

  if a<5 and n-b> _
      4+5+h/7*2 or  _
      t=4: p 'TTTTTTTTT' _
    & cla & $f='Text Variable' _
    & goto 'FFFF'
  

  • Группа строк, разделённых " _", считается одной строкой (сообщения об ошибках также выводятся с учётом того, что это одна строка).
  • После OR стоит не один, а два пробела - один пробел расходуется на " _" и получилось бы "ort=4" вмето "or t=4".
    • Исправлено: в более новых версиях (Quest Navigator, возможно даже в AeorQSP) пробел сохраняется.

Для пояснений в коде удобно использовать комментарии, которые игнорируются интерпретатором (плеером):

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

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

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

Пример вызова функции: 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] ",'Текст','Вилка'

Вперёд: