diff options
author | Robert Griesemer <gri@golang.org> | 2010-07-14 16:09:22 -0700 |
---|---|---|
committer | Robert Griesemer <gri@golang.org> | 2010-07-14 16:09:22 -0700 |
commit | dc60c5a7ec6be11d494fcba8421b0f68324c8eb1 (patch) | |
tree | 81491ee0c8697d9a816c5db5762c26182612860e | |
parent | 708d7160fa84ee79924fc7cf0bc29acb03406e6f (diff) | |
download | go-dc60c5a7ec6be11d494fcba8421b0f68324c8eb1.tar.gz go-dc60c5a7ec6be11d494fcba8421b0f68324c8eb1.zip |
go spec: clarification of channel close()
R=r, rsc
CC=golang-dev
https://golang.org/cl/1766042
-rw-r--r-- | doc/go_spec.html | 17 |
1 files changed, 10 insertions, 7 deletions
diff --git a/doc/go_spec.html b/doc/go_spec.html index 598bc928d3..13b3a90704 100644 --- a/doc/go_spec.html +++ b/doc/go_spec.html @@ -1,5 +1,5 @@ <!-- title The Go Programming Language Specification --> -<!-- subtitle Version of July 12, 2010 --> +<!-- subtitle Version of July 14, 2010 --> <!-- TODO @@ -4347,14 +4347,17 @@ BuiltinArgs = Type [ "," ExpressionList ] | ExpressionList . <h3 id="Close_and_closed">Close and closed</h3> <p> -For a channel <code>c</code>, the predefined function <code>close(c)</code> -marks the channel as unable to accept more -values through a send operation. After any previously +For a channel <code>c</code>, the built-in function <code>close(c)</code> +marks the channel as unable to accept more values through a send operation; +values sent to a closed channed are ignored. +After calling <code>close</code>, and after any previously sent values have been received, receive operations will return -the zero value for the channel's type. After at least one such zero value has been +the zero value for the channel's type without blocking. +After at least one such zero value has been received, <code>closed(c)</code> returns true. </p> + <h3 id="Length_and_capacity">Length and capacity</h3> <p> @@ -4560,10 +4563,10 @@ func recover() interface{} </pre> <p> -<font color=red>TODO: Most of this text could move to the respective +<span class="alert">TODO: Most of this text could move to the respective comments in <code>runtime.go</code> once the functions are implemented. They are here, at least for now, for reference and discussion. -</font> +</span> </p> <p> |