lovr.task.wait

Edit

Waits for one or more tasks to complete, returning any values they return.

Note that this is an async function. Waiting on a task while inside another task will yield the waiter until the waitee is done.

... = lovr.task.wait(...task)
... = lovr.task.wait(t)

Notes

After waiting on a task, it will not show up in lovr.taskready, since it will never be ready to run again.

Waiting on a task requires that it was resumed with lovr.task.resume.

If some of the tasks aren't finished yet when this function is called, LÖVR will try to find something useful to do, including resuming tasks that are ready to run and running some of the work that tasks are waiting for.

Examples

Loading multiple images in parallel.

local tasks = {}

for i, file in ipairs(files) do
  tasks[i] = lovr.task.start(function()
    return lovr.graphics.newTexture(file)
  end)
end

local textures = lovr.task.wait(tasks)

Multiple return values.

local a = lovr.task.start(function()
  return 1, 2, 3
end)

local b = lovr.task.start(function()
  return 4, 5, 6
end)

local c = lovr.task.start(function()
  return 7, 8, 9
end)

print(lovr.task.wait(a, b, c)) --> true, 1, 4, 7, 8, 9

See also

• lovr.task