Итоги

На этом уроке вы узнали, что:

• Сопрограмма — это функция, которая умеет приостанавливаться посередине и потом продолжать с того же места, сохраняя свои локальные переменные. Игры используют сопрограммы для дел, которые занимают несколько ходов или кадров.
• coroutine.create(f) создаёт сопрограмму из функции f (после f нет скобок). coroutine.resume(co) запускает её до следующего coroutine.yield() или до конца функции. Сопрограмма — значение типа thread, а не функция, поэтому co() падает с ошибкой attempt to call a thread value.
• coroutine.status(co) — это suspended (ещё не запускалась или на паузе), running или dead (завершилась).
• coroutine.yield() вне сопрограммы, например в функции, которую вы вызвали сами, заканчивается ошибкой attempt to yield from outside a coroutine.
• coroutine.yield(v) отдаёт v наружу: resume возвращает true и v. coroutine.resume(co, x) передаёт x внутрь: первый resume — в параметры функции, каждый следующий — как результат того yield, на котором сопрограмма ждёт.
• Цикл while true do с yield внутри не бесконечный: он останавливается на каждом yield.
• coroutine.wrap(f) возвращает генератор: функцию, которая возобновляет сопрограмму и возвращает только значения из yield. Он подходит для for … in, который останавливается, когда функция сопрограммы заканчивается. Исчерпанный генератор нельзя запустить заново; создайте новый.
• В игре у каждого персонажа может быть сопрограмма с его сценарием. Игровой цикл возобновляет каждую из них один раз за ход. Они ходят по очереди и никогда не работают одновременно.
• Ошибка внутри сопрограммы останавливает только её саму: resume возвращает false и сообщение, а сопрограмма становится dead. Возобновление мёртвой сопрограммы даёт false и cannot resume dead coroutine. Поэтому проверяйте первое значение. Генератор из wrap передаёт ошибки дальше, и программа останавливается.

В следующем уроке, итоговом проекте, вы соберёте весь курс воедино: сезон на ферме Эммы, одна программа, написанная шаг за шагом, от покупки семян до продажи урожая. Торговец Гуго там тоже будет, конечно, в виде сопрограммы.

Но сначала потренируйтесь на материале этого урока. Эмма собирается поливать поле; список её грядок уже в редакторе.