coroutine

คอรูติน ถูกใช้เพื่อดําเนินการภารกิจหลายอย่างพร้อมกันในเวลาเดียวกันจากสคริปต์เดียวกันภารกิจดังกล่าวอาจรวมถึงการผลิตค่าจากอินพุตหรือทำงานบนสับรูติเมื่อแก้ปัญหาที่ใหญ่กว่างานไม่จำเป็นต้องมีจุดสิ้นสุดที่กำหนดไว้ แต่ต้องกำหนดเวลาเฉพาะที่จะให้หยุด (หยุดชะงัก) เพื่อให้สิ่งอื่นๆ สามารถทำงานได้

ใช้ Coroutines

สามารถสร้าง coroutine ใหม่ได้โดยการให้ฟังก์ชันแก่ coroutine.create()เมื่อสร้างแล้ว coroutine จะไม่เริ่มทำงานจนกว่าจะมีการโทรครั้งแรกไปที่ coroutine.resume() ซึ่งส่งอาร์กิวเมนต์ไปยังฟังก์ชันการโทรนี้จะกลับเมื่อฟังก์ชันหยุดหรือเรียก coroutine.yield() และเมื่อเกิดเหตุนี้ขึ้น coroutine.resume() จะคืนค่าที่กลับโดยฟังก์ชัน หรือค่าที่ส่งไปยัง coroutine.yield() หรือข้อความข้อผิดพลาดหากเกิดข้อผิดพลาด ค่าการ返回ที่สองคือข้อผิดพลาดที่โยน

local function task(...)
	-- ฟังก์ชันนี้อาจทำงานบางอย่างสักครู่แล้วแสดงค่าบางอย่าง
	coroutine.yield("first")  -- จะถูกส่งคืนโดย coroutine.resume()
	-- ฟังก์ชันจะดำเนินต่อไปเมื่อถูกระงับอีกครั้ง
	return "second"
end

local taskCoro = coroutine.create(task)
-- เรียกการดำเนินการต่อเมื่อครั้งแรกซึ่งทำงานตั้งแต่ต้น
local success, result = coroutine.resume(taskCoro, ...)
print(success, result)  --> จริงก่อน (ภารกิจที่เรียกว่า coroutine.yield()}
-- ดำเนินการใช้ฟังก์ชันต่อไปจนกว่าจะให้ผลหรือหยุด
success, result = coroutine.resume(taskCoro)
print(success, result)  --> true, second (task halted because it returned "second")

ในระหว่างชีวิตของ coroutine คุณสามารถโทร coroutine.status() เพื่อตรวจสอบสถานะของมัน:

<th>ความหมาย</th>
  </tr>
</thead>

<tbody>
  <tr>
    <td><b>ระงับ</b></td>

    <td>คอรูตินกำลังรอการดำเนินการต่อ คอรูตินเริ่มในสถานะนี้และเข้าสู่สถานะนี้เมื่อฟังก์ชันของพวกเขาเรียก <code>coroutine.yield()</code></td>
  </tr>

  <tr>
    <td><b>กำลังดำเนินการ</b></td>

    <td>คอรูตินกำลังดำเนินการอยู่ในขณะนี้</td>
  </tr>

  <tr>
    <td><b>ปกติ</b></td>

    <td>คอรูตินกำลังรอผลผลิตของคอรูตินอื่น; คือกล่าวอีกนัยหนึ่งมันได้เริ่มคอรูตินอื่นอีกครั้ง</td>
  </tr>

  <tr>
    <td><b>ตาย</b></td>

    <td>ฟังก์ชันถูกหยุด (กลับหรือโยนข้อผิดพลาด) คอรูตินไม่สามารถใช้ต่อได้</td>
  </tr>
</tbody>

การห่อคอรูติน

เมื่อทำงานกับ coroutine คุณยังสามารถข้ามการใช้วัตถุ coroutine และใช้ฟังก์ชัน wrapper แทนฟังก์ชัน wrapper ดังกล่าวจะดำเนินการต่อคอรูตินที่เฉพาะเจาะจงเมื่อเรียกและจะส่งคืนเฉพาะค่าที่ได้รับเท่านั้นคุณสามารถทำเช่นนี้โดยใช้ coroutine.wrap() :

-- สร้าง coroutine และส่งคืนฟังก์ชันห่อที่ระงับมัน
local f = coroutine.wrap(task)
-- ดำเนินการต่อคอรูตินต่อไปเหมือนว่าเราเรียก coroutine.resume()
local result = f()
-- หากเกิดข้อผิดพลาดจะถูกยกขึ้นที่นี่!
-- This differs from coroutine.resume() which acts similar to pcall()

ค่าแรกที่ส่งกลับจาก coroutine.resume() อธิบายว่าคอรูตินทำงานโดยไม่มีข้อผิดพลาดหรือไม่อย่างไรก็ตาม ฟังก์ชันที่ส่งคืนโดย coroutine.wrap() จะไม่ทำเช่นนี้: แทนที่จะส่งค่ากลับโดยตรงหรือส่งไปยัง coroutine.yield() หากมีหากเกิดข้อผิดพลาดขณะทำงานฟังก์ชัน coroutine ข้อผิดพลาดจะถูกยกขึ้นในการโทรของฟังก์ชันที่ส่งคืน

ตัวอย่างลายผลิตภัณฑ์

จินตนาการถึงงานที่ผลิตการทำซ้ำของคํา: ทุกครั้งที่ผลิตการทำซ้ำครั้งต่อไปจะผลิตอีกหนึ่งตัวอย่างเช่นการให้ Hello จะผลิต Hello , HelloHello , HelloHelloHello ฯลฯเพื่อทําเช่นนี้คุณสามารถกําหนด repeatThis() :

-- ฟังก์ชันนี้ทำซ้ำคําทุกครั้งที่คอรูตินถูกระงับใหม่
local function repeatThis(word)
	local repetition = ""
	while true do
		-- ผลการค้นหา
		repetition = repetition .. word
		coroutine.yield(repetition)
	end
end

เพื่อรันฟังก์ชันนี้เป็น coroutine คุณสามารถใช้ coroutine.create() ตามด้วยการโทรหลายครั้งไปที่ coroutine.resume() :

local repetitionCoro = coroutine.create(repeatThis)
print(coroutine.resume(repetitionCoro, "Hello"))  -- จริง, สวัสดี
print(coroutine.resume(repetitionCoro))           -- จริง, HelloHello
print(coroutine.resume(repetitionCoro))           -- true, HelloHelloHello

สำหรับฟังก์ชันผู้ผลิตนี้คุณสามารถใช้ coroutine.wrap() เพื่อรับฟังก์ชันที่ผลิตค่าได้:

local f = coroutine.wrap(repeatThis)
print(f("Hello"))  -- สวัสดี
print(f())         -- สวัสดีสวัสดี
print(f())         -- HelloHelloHello