coroutine

Một coroutine được sử dụng để thực hiện nhiều nhiệm vụ cùng một lúc từ trong cùng một kịch bản.Các nhiệm vụ như vậy có thể bao gồm sản xuất giá trị từ đầu vào hoặc thực hiện công việc trên một subroutine khi giải quyết một vấn đề lớn hơn.Một nhiệm vụ thậm chí không cần phải có điểm kết thúc được xác định, nhưng nó cần phải xác định các thời điểm cụ thể mà nó phát (tạm dừng) để cho phép các thứ khác được thực hiện.

Sử dụng Coroutines

Một coroutine mới có thể được tạo bằng cách cung cấp một chức năng cho coroutine.create().Một khi đã tạo, một coroutine không bắt đầu chạy cho đến khi cuộc gọi đầu tiên đến coroutine.resume() mà truyền các tham số cho chức năng.Cuộc gọi này trả về khi chức năng dừng lại hoặc gọi coroutine.yield() hoặc, khi điều này xảy ra, coroutine.resume() trả về các giá trị được trả bởi chức năng, các giá trị được gửi đến coroutine.yield() hoặc một thông tin nhắnlỗi.Nếu xảy ra lỗi, giá trị trả lại thứ hai là lỗi được ném.

local function task(...)
	-- Chức năng này có thể làm một số công việc trong một lúc rồi sau đó cho ra một số giá trị
	coroutine.yield("first")  -- Sẽ được trả lại bởi coroutine.resume()
	-- Chức năng tiếp tục một khi nó được khởi động lại
	return "second"
end

local taskCoro = coroutine.create(task)
-- Gọi lại lần đầu tiên, chạy chức năng từ đầu
local success, result = coroutine.resume(taskCoro, ...)
print(success, result)  --> true, trước tiên (nhiệm vụ gọi coroutine.yield())
-- Tiếp tục chạy chức năng cho đến khi nó hiển thị hoặc dừng lại
success, result = coroutine.resume(taskCoro)
print(success, result)  --> true, second (task halted because it returned "second")

Trong suốt cuộc sống của coroutine, bạn có thể gọi coroutine.status() để kiểm tra tình trạng tháicủa nó:

<th>Ý nghĩa</th>
  </tr>
</thead>

<tbody>
  <tr>
    <td><b>bị treo</b></td>

    <td>Hàng đợi đang chờ được tiếp tục. Các hàng đợi bắt đầu trong trạng thái này và nhập vào khi chức năng của chúng gọi <code>coroutine.yield()</code>.</td>
  </tr>

  <tr>
    <td><b>chạy</b></td>

    <td>Coroutine đang chạy ngay bây giờ.</td>
  </tr>

  <tr>
    <td><b>bình thường</b></td>

    <td>Coroutine đang chờ đợi sản phẩm của một coroutine khác; theo cách khác, nó đã khởi động lại một coroutine khác.</td>
  </tr>

  <tr>
    <td><b>chết</b></td>

    <td>Chức năng đã dừng lại (trả về hoặc ném một lỗi). Coroutine không thể được sử dụng tiếp theo.</td>
  </tr>
</tbody>

Bọc lại Coroutines

Khi làm việc với các coroutine, bạn cũng có thể bỏ qua việc sử dụng đối tượng coroutine và thay vào đó sử dụng chức năng bọc.Một chức năng bọc như vậy sẽ tiếp tục một coroutine cụ thể khi nó được gọi và sẽ trả lại chỉ các giá trị được trả.Bạn có thể làm điều này bằng cách sử dụng coroutine.wrap() :

-- Tạo coroutine và trả về một chức năng bọc lại nó khởi động lại
local f = coroutine.wrap(task)
-- Tiếp tục cuộc gọi coroutine như thể chúng ta đã gọi coroutine.resume()
local result = f()
-- Nếu xảy ra lỗi, nó sẽ được nâng lên ở đây!
-- This differs from coroutine.resume() which acts similar to pcall()

Giá trị đầu tiên được trả về từ coroutine.resume() mô tả xem một coroutine có chạy mà không có lỗi hay không.Tuy nhiên, chức năng được trả về bởi coroutine.wrap() sẽ không làm điều này: thay vào đó, chúng trực tiếp trả lại các giá trị được trả hoặc được chuyển đến coroutine.yield(), nếu có.Nếu một lỗi đã xảy ra trong khi chạy chức năng coroutine, lỗi được nâng lên trong cuộc gọi của chức năng trả về.

Ví dụ mô hình sản xuất

Hãy tưởng tượng một nhiệm vụ sản xuất lặp lại của một từ: mỗi khi nó sản xuất một lặp lại, lần tiếp theo sẽ sản xuất thêm một lần.Ví dụ, cung cấp Hello sẽ sản xuất Hello , HelloHello , HelloHelloHello , v.v.Để làm điều này, bạn có thể định nghĩa repeatThis() :

-- Chức năng này lặp lại một từ mỗi khi coroutine được khởi động lại
local function repeatThis(word)
	local repetition = ""
	while true do
		-- Lặp lại một lần rồi lấy kết quả
		repetition = repetition .. word
		coroutine.yield(repetition)
	end
end

Để chạy chức năng này như một coroutine, bạn có thể sử dụng coroutine.create() theo sau bởi nhiều cuộc gọi đến coroutine.resume() :

local repetitionCoro = coroutine.create(repeatThis)
print(coroutine.resume(repetitionCoro, "Hello"))  -- đúng, Xin chào
print(coroutine.resume(repetitionCoro))           -- đúng, HelloHello
print(coroutine.resume(repetitionCoro))           -- true, HelloHelloHello

Đối với chức năng sản xuất này, bạn cũng có thể sử dụng coroutine.wrap() để có được một chức năng sản xuất giá trị:

local f = coroutine.wrap(repeatThis)
print(f("Hello"))  -- Xin chào
print(f())         -- Xin chàoHello
print(f())         -- HelloHelloHello