From 686bf3bfc6a492304e7f662a8da8fff436cba53e Mon Sep 17 00:00:00 2001 From: flywind Date: Fri, 12 Mar 2021 22:18:10 +0800 Subject: clarify the behavior of newChan follow up the advice of `timothee` --- lib/std/channels.nim | 4 ++++ 1 file changed, 4 insertions(+) (limited to 'lib/std') diff --git a/lib/std/channels.nim b/lib/std/channels.nim index a212af0d3..1b0844c48 100644 --- a/lib/std/channels.nim +++ b/lib/std/channels.nim @@ -506,5 +506,9 @@ func close*[T](c: Channel[T]): bool {.inline.} = func peek*[T](c: Channel[T]): int {.inline.} = peek(c.d) proc newChannel*[T](elements = 30): Channel[T] = + ## Returns a new `Channel`. `elements` should be positive. + ## `elements` is used to specify whether a channel is buffered or not. + ## If `elements` = 1, the channel is unbuffered. If `elements` > 1, the + ## channel is buffered. assert elements >= 1, "Elements must be positive!" result = Channel[T](d: allocChannel(sizeof(T), elements)) -- cgit 1.4.1-2-gfad0