Commit 52572afa authored by Josh Bleecher Snyder's avatar Josh Bleecher Snyder

reflect,doc: use "the" instead of "a" in IsZero docs

There is a subtle distinction between a value
*being* the zero value vs being *equal to* the zero value.
This was discussed at length in #31450.

Using "a zero value" in the docs suggests that there may
be more than zero value. That is possible on the "equal to
zero value" reading, but not the "is zero" reading that we
selected for the semantics of IsZero.

This change attempts to prevent any confusion on this front by
switching to "the zero value" in the documentation.

And while we're here, eliminate a double-space.
(Darn macbook keyboards.)

Change-Id: Iaa02ba297438793f5a90be9919a4d53baef92f8e
Reviewed-on: https://go-review.googlesource.com/c/go/+/182617
Run-TryBot: Josh Bleecher Snyder <josharian@gmail.com>
TryBot-Result: Gobot Gobot <gobot@golang.org>
Reviewed-by: default avatarBrad Fitzpatrick <bradfitz@golang.org>
parent bc27b64d
...@@ -292,11 +292,11 @@ TODO ...@@ -292,11 +292,11 @@ TODO
<dl id="reflect"><dt><a href="/pkg/reflect/">reflect</a></dt> <dl id="reflect"><dt><a href="/pkg/reflect/">reflect</a></dt>
<dd> <dd>
<p><!-- CL 171337 --> <p><!-- CL 171337 -->
The new <a href="/pkg/reflect/#Value.IsZero"><code>Value.IsZero</code></a> method reports whether a <code>Value</code> is a zero value for its type. The new <a href="/pkg/reflect/#Value.IsZero"><code>Value.IsZero</code></a> method reports whether a <code>Value</code> is the zero value for its type.
</p> </p>
<p><!-- CL 174531 --> <p><!-- CL 174531 -->
The <a href="/pkg/reflect/#MakeFunc"><code>MakeFunc</code></a> function now allows assignment conversions on returned values, instead of requiring exact type match. This is particularly useful when the type being returned is an interface type, but the value actually returned is a concrete value implementing that type. The <a href="/pkg/reflect/#MakeFunc"><code>MakeFunc</code></a> function now allows assignment conversions on returned values, instead of requiring exact type match. This is particularly useful when the type being returned is an interface type, but the value actually returned is a concrete value implementing that type.
</p> </p>
</dl><!-- reflect --> </dl><!-- reflect -->
......
...@@ -1076,7 +1076,7 @@ func (v Value) IsValid() bool { ...@@ -1076,7 +1076,7 @@ func (v Value) IsValid() bool {
return v.flag != 0 return v.flag != 0
} }
// IsZero reports whether v is a zero value for its type. // IsZero reports whether v is the zero value for its type.
// It panics if the argument is invalid. // It panics if the argument is invalid.
func (v Value) IsZero() bool { func (v Value) IsZero() bool {
switch v.kind() { switch v.kind() {
......
Markdown is supported
0%
or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment