ТОМ2: функции: различия между версиями
Содержимое удалено Содержимое добавлено
ASBer (обсуждение | вклад) |
ASBer (обсуждение | вклад) |
||
| (не показано 40 промежуточных версий этого же участника) | |||
Строка 1:
{{содержание справа}}
==Назначение==
Функции
Пример вызова фукции:
Строка 13:
''fn_type'' ( ''arg_list'' ) { ''code'' }
'''Где:'''
*''fn_type'' - ключевое слово, определяющее тип функции: ''expression'' (''выражение''), ''action'' (''действие''), ''fact'' (''факт'');
*''arg_list'' - список аргументов;
*''code'' - код тела функции, разделённый на секции.
Строка 31:
* Тип значения: bool, string, number, course, spcvalue, object, attribute, class, location, word, preposition, and-list, or-list.
* Класс значения.
* Имя
* Произвольный литерал - должен в точности совпасть со словом, введенным игроком. Пример: "трах-тибидох"
Строка 54:
Если ключ не указан, проверка значения на соответствие ключу не проводится.
==Типы
Существует три типа функций – выражения, факты, действия.
Строка 60:
# Парсинг
# Выполнение строки
Ели строка однозначно разобрана, она выполняется. Выполняется строка только один раз.
Строка 70:
Разбор команд на естественном языке требует проведение вычислений уже на этапе парсинга, когда смысл строки еще не понятен. Для этого необходимо по разному обрабатывать функции изменяющие и не изменяющие состояние игры. Изменение состояния игры допустимо только после однозначного разбора строки.
=== Функции типа
Выражения вычисляются на этапе разбора (парсинга) строки и ''не приводят к изменениям состояния игры''.
Строка 83:
2 + 2
X + 3
'''Пример функции выражения:'''
Строка 95 ⟶ 94 :
}
=== Функции типа action (действие) ===
Действия ''изменяют состояние игры''.
Строка 109 ⟶ 106 :
покрась стены в зелёный цвет
возьми 3 рубля
'''Пример функции действия:'''
action(иди
{ == check ==
if loc = напр then fail, "ты уже здесь"
Строка 121 ⟶ 117 :
}
===
Факты применяются в качестве условий или вопросов, а так же как утверждения:
Если цвет стен зеленый, то … // условие
Строка 144 ⟶ 140 :
}
==Секции в функциях==
Код функции делится на секции. Каждая секция имеет своё имя и выполняется на определённом этапе парсинга.
Начало секции обозначается знаками ==, после которых идёт имя секции.
Пример:
== parsing ==
... код секции ...
Код, размещенный перед первой секцией, является общим и выполняется всегда.
Пример:
action(дай#Пф, Маша#Дп, мяч#Вп)
{ ...общий код...
==parsing==
...код парсинга...
==check==
...код проверки...
==execute==
...код выполнения...
}
===Секции в выражениях===
В выражениях используются секции parsing (парсинг) и execute (выполнение).
====Секция parsing (парсинг) в выражениях====
Эта секция вызывается на этапе синтаксического анализа строки кода или командной строки.
Здесь нужно проверить синтаксическую правильность переданных аргументов, например то что прилагательное стоит перед существительным и согласуется с ним по роду, числу, падежу и одушевлённости.
Если набор переданных аргументов не соответствует синтаксису команды, секция должна вернуть ошибку.
секция parsing может быть опущена, если дополнительной проверки синтаксиса не требуется.
=====Проверка позиций аргументов=====
описать!
====Секция execute (выполнение) в выражениях====
Секция вычисляет значение выражения.
В выражениях эта cекция исполняется на этапе парсинга, из чего следует:
#выполнение этой секции может происходить многократно;
#результат выражения может быть вариантным;
#в этой секции нельзя менять состояния объектов и переменных (за исключением переменных самой функции);
#результат выражения влияет на дальнейший парсинг команды.
Пример:
выражение (среднее, число А, число Б)
{
==выполнение==
(А + Б)/2
}
В данном примере функция вычисляет среднее значение двух чисел.
Обращаться к функции из кода можно следующим образом.
Пример:
var X = среднее 4 5;
var A = 2
var Б = 7
%{среднее А Б} //переменные А и Б должны содержать числа
===Секции в фактах===
В фактах используются секции parsing (парсинг), check (проверка), и execute (выполнение).
====Секция parsing (парсинг) в фактах====
Работает аналогично секции parsing в выражениях.
====Секция check (проверка) в фактах====
Эта секция проверяет факт на его соответствие действительности и возвращает логическое '''да''' или '''нет'''.
Секция исполняется на этапе парсинга, из чего следует:
#выполнение этой секции может происходить многократно;
#в этой секции нельзя менять состояния объектов и переменных (за исключением переменных самой функции);
Именно эта секция позволяет использовать факты в условных конструкциях и вопросах.
Пример:
факт (предмет А, весит, число Б, кг)
{
==проверка==
А.вес = Б?
==выполнение==
... код выполнения ...
}
Пример условия:
если камень весит 100 кг то ...
Пример вопроса:
камень весит 100 кг?
====Секция execute (выполнение) в фактах====
В факте секция execute (выполнение) выполняется после однозначного разбора строки кода или команды.
Эта секция должна сделать так, чтобы факт стал истинным.
Пример:
факт (предмет А, весит, число Б, кг)
{
==проверка==
А.вес = Б?
==выполнение==
А.вес = Б
}
По своей сути факт – это инструмент создателя игры, позволяющий перекроить игровой мир. То, что указывается в факте, становится истинным.
Пример:
камень весит 100 кг. //да будет так
В связи с этим, секция execute (выполнение) для фактов работает только в режиме 'вне игры' (см. раздел Режимы работы ТОМ), иначе игрок мог бы очень сильно изменить игровой мир.
===Секции в действиях===
В действиях используются секции: parsing (парсинг), check (проверка) и execute (выполнение).
====Секция parsing (парсинг) в действиях====
Работает аналогично секции parsing в выражениях.
====Секция check (проверка) в действиях====
В этой секции мы должны проверить физическую возможность выполнения команды. Есть ли у нас все предметы, названные в команде, соблюдены ли условия, необходимые для начала выполнения действия и т.п.
Секция исполняется на этапе парсинга, из чего следует:
#выполнение этой секции может происходить многократно;
#в этой секции нельзя менять состояния объектов и переменных (за исключением переменных самой функции);
Если действие невозможно, секция должна вернуть ошибку.
====Секция execute (выполнение) в действиях====
В этой секции описывается выполнение действия, соответствующего команде. Здесь можно изменить состояние игры, вывести текст с описанием произошедшего события и т.д.
==Сообщения об ошибках выполнения функций==
описать!
[[Категория:Документация ТОМ2]]
| |||