coroutine create & resume

Parte da seção Logic & Flow do Journey de Lua da Coddy — lição 49 de 54.

Agora que você entende o que são corrotinas, vamos aprender como realmente criá-las e executá-las em Lua.

Para criar uma corrotina, você usa a função coroutine.create(). Esta função recebe uma função comum como seu argumento e a envolve em um objeto de corrotina. Aqui está a sintaxe básica:

function myTask()
    print("Hello from coroutine!")
end

local co = coroutine.create(myTask)

Neste ponto, a corrotina existe, mas ainda não começou a ser executada. A função myTask não foi chamada. Para efetivamente iniciar ou continuar a execução de uma corrotina, você usa coroutine.resume():

coroutine.resume(co)

Quando você chama resume() em uma corrotina pela primeira vez, ela começa a ser executada a partir do início de sua função. Se a corrotina for executada até o fim sem pausar, ela é concluída e não pode ser retomada novamente.

Aqui está um exemplo completo:

function greet()
    print("Starting...")
    print("Finishing!")
end

local co = coroutine.create(greet)
coroutine.resume(co)  -- Imprime ambas as mensagens

A corrotina é executada do início ao fim de uma só vez. Na próxima lição, você aprenderá como fazer as corrotinas pausarem no meio da execução.

Desafio

Fácil

Escreva uma função runSimpleCoroutine que recebe uma message e retorna a saída de uma coroutine que imprime essa mensagem.

Crie uma coroutine usando coroutine.create() que envolve uma função que imprime a mensagem fornecida. Em seguida, use coroutine.resume() para executar a coroutine. A função deve retornar a mensagem que foi impressa.

Lógica:

Defina uma função que imprime o parâmetro message
Crie uma coroutine a partir dessa função usando coroutine.create()
Retome a coroutine usando coroutine.resume()
Retorne a mensagem que foi impressa

Parâmetros:

message (string): A mensagem a ser impressa pela coroutine

Retorna: A mensagem que foi impressa pela coroutine (string)

Folha de consulta

Para criar uma coroutine, use coroutine.create() com uma função como seu argumento:

function myTask()
    print("Hello from coroutine!")
end

local co = coroutine.create(myTask)

Para iniciar ou continuar a execução de uma coroutine, use coroutine.resume():

coroutine.resume(co)

Exemplo completo:

function greet()
    print("Starting...")
    print("Finishing!")
end

local co = coroutine.create(greet)
coroutine.resume(co)  -- Imprime ambas as mensagens

Quando resume() é chamado pela primeira vez, a coroutine começa a ser executada desde o início. Se ela for executada até o fim sem pausar, não poderá ser retomada novamente.

Experimente você mesmo

function runSimpleCoroutine(message)
    -- Escreva o código aqui
end

Teste seus conhecimentos

Esta lição inclui um quiz rápido. Comece a lição para respondê-lo e acompanhar seu progresso.

Todas as lições de Logic & Flow

1Iteração Avançada de Tabelas

Iterando com pairs()Iterando com ipairs()pairs() vs. ipairs()Revisão - Ficha de Personagem

4Introdução às Metatabelas

O que é uma Metatabela?setmetatable & getmetatable O Metamétodo __index O Metamétodo __newindex O Metamétodo __tostring Metamétodos Aritméticos Parte 1 Metamétodos Aritméticos Parte 2 Recapitulação - Tabela Somente Leitura

7Manipulação Avançada de Strings

string.gsub() para Substituição Introdução a Padrões de String string.find()string.match()Iteração com string.gmatch()Recapitulação - Parser de Arquivos de Log

2Mais Funções da Biblioteca Table

table.concat()Construção de tabelas e unpack()table.sort()Ordenação personalizada com funções Recapitulação - Placar de recordes

5Projeto: Engine de Aventura de Texto

Configuração do Projeto: A Sala Conectando as Salas

Estado do Jogador

O Game Loop

Processando a Entrada do Usuário

Movendo o Jogador

Tratando Movimentos Inválidos

Exibindo as Saídas

8Projeto: Lista de Contatos

Configuração do Projeto O Loop Principal

Adicionando um Contato

Listando Todos os Contatos

Buscando um Contato

Excluindo um Contato

Tratando Entradas Inválidas

3Conceitos Avançados de Funções

Retornando Múltiplos Valores Funções Variádicas (...)Funções como Valores de Primeira Classe Funções Anônimas O que é uma Closure?Recapitulação - Manipulador de Eventos Simples

6Tratamento de Erros

A Função error()Chamadas Protegidas com pcall()Recapitulação - Divisão Segura

9Coroutines para Iniciantes

O que é uma Coroutine?coroutine create & resumePausando com coroutine.yield()resume & yield Verificando o Status da Coroutine Recapitulação - Gerador de Números Recapitulação - Matemática de Vetores