mirrors/Nim
1
0
Fork 0
mirror of https://github.com/nim-lang/Nim.git synced 2026-01-07 21:43:33 +00:00
Code Issues Packages Projects Releases Wiki Activity

add comments to spawn and pinnedSpawn (#19230)

Browse Source 
`spawn` uses `nimSpawn3` internally and `pinnedSpawn` uses `nimSpawn4` internally. I comment it in order to help contributors get the gist of its functionality.
This commit is contained in:
flywind
2021-12-10 01:49:31 +08:00
committed by GitHub
parent 99f8793502
commit 4f64c9fae5
1 changed files with 4 additions and 2 deletions
Download Patch File Download Diff File Expand all files Collapse all files

6
lib/pure/concurrency/threadpool.nim
View File

@@ -448,19 +448,21 @@ proc preferSpawn*(): bool =
## <#spawnX.t>`_ instead.
result = gSomeReady.counter > 0
proc spawn*(call: sink typed) {.magic: "Spawn".}
proc spawn*(call: sink typed) {.magic: "Spawn".} =
## Always spawns a new task, so that the `call` is never executed on
## the calling thread.
##
## `call` has to be a proc call `p(...)` where `p` is gcsafe and has a
## return type that is either `void` or compatible with `FlowVar[T]`.
discard "It uses `nimSpawn3` internally"
proc pinnedSpawn*(id: ThreadId; call: sink typed) {.magic: "Spawn".}
proc pinnedSpawn*(id: ThreadId; call: sink typed) {.magic: "Spawn".} =
## Always spawns a new task on the worker thread with `id`, so that
## the `call` is **always** executed on the thread.
##
## `call` has to be a proc call `p(...)` where `p` is gcsafe and has a
## return type that is either `void` or compatible with `FlowVar[T]`.
discard "It uses `nimSpawn4` internally"
template spawnX*(call) =
## Spawns a new task if a CPU core is ready, otherwise executes the