From 27a3d2b127018e5b14982ba7a99e182ecd32dbe5 Mon Sep 17 00:00:00 2001 From: Travis CI <> Date: Sun, 4 Apr 2021 19:25:24 +0000 Subject: [PATCH] Deploy to GitHub Pages: --- modules/core/fiber.html | 62 +++++++++++++++++++++++++++++++++++++++-- 1 file changed, 59 insertions(+), 3 deletions(-) diff --git a/modules/core/fiber.html b/modules/core/fiber.html index b36fe8cc..426ff898 100644 --- a/modules/core/fiber.html +++ b/modules/core/fiber.html @@ -235,11 +235,67 @@ System.print("Caught error: " + error)
If the called fiber raises an error, it can no longer be used.
TODO
+Pauses execution of the current running fiber, and transfers control to this fiber.
+[Read more][../../concurrency.html#transferring-control] about the difference
+between call and transfer. Unlike call, transfer doesn’t track the origin of the transfer.
+// keep hold of the fiber we start in
+var main = Fiber.current
+
+// create a new fiber, note it doesn't execute yet!
+var fiber = Fiber.new {
+ System.print("inside 'fiber'") //> #2: from #1
+ main.transfer() //> #3: go back to 'main'
+}
+
+fiber.transfer() //> #1: print "inside 'fiber'" via #2
+ //> this fiber is now paused by #1
+
+System.print("main") //> #4: prints "main", unpaused by #3
+
+
TODO
+Pauses execution of the current running fiber, and transfers control to this fiber.
+Similar to transfer, but a value can be passed between the fibers.
+// keep hold of the fiber we start in
+var main = Fiber.current
+
+// create a new fiber, note it doesn't execute yet
+// also note that we're accepting a 'value' parameter
+var fiber = Fiber.new {|value|
+ System.print("in 'fiber' = %(value)") //> #2: in 'fiber' = 5
+ var result = main.transfer("hello?") //> #3: send to 'message'
+ System.print("end 'fiber' = %(result)") //> #6: end 'fiber' = 32
+}
+
+var message = fiber.transfer(5) //> #1: send to 'value'
+System.print("... %(message)") //> #4: ... hello?
+fiber.transfer(32) //> #5: send to 'result'
+
+
TODO
+Transfer to this fiber, but set this fiber into an error state.
+The fiber.error value will be populated with the value in error.
+var A = Fiber.new {
+ System.print("transferred to A") //> #4
+ B.transferError("error!") //> #5
+}
+
+var B = Fiber.new {
+ System.print("started B") //> #2
+ A.transfer() //> #3
+ System.print("should not get here")
+}
+
+B.try() //> #1
+System.print(B.error) //> #6: prints "error!" from #5
+
+// B fiber can no longer be used
+
+B.call() //> #7: Cannot call an aborted fiber.
+