qbit/go
1
0
Fork 0
mirror of https://github.com/golang/go synced 2024-11-22 00:04:41 -07:00
Code Releases Activity

go spec: rename "assignment compatible" -> "assignable"

Browse Source 
R=r, rsc
CC=golang-dev
https://golang.org/cl/1590041
This commit is contained in:
Robert Griesemer 2010-06-07 17:40:21 -07:00
parent 9b3c743f82
commit 440cc95470
1 changed files with 25 additions and 27 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

52
doc/go_spec.html
View File

@ -648,7 +648,7 @@ type defined by its declaration. Variables of interface type
also have a distinct <i>dynamic type</i>, which also have a distinct <i>dynamic type</i>, which
is the actual type of the value stored in the variable at run-time. is the actual type of the value stored in the variable at run-time.
The dynamic type may vary during execution but is always The dynamic type may vary during execution but is always
<a href="#Assignment_compatibility">assignment compatible</a> <a href="#Assignability">assignable</a>
to the static type of the interface variable. For non-interface to the static type of the interface variable. For non-interface
types, the dynamic type is always the static type. types, the dynamic type is always the static type.
</p> </p>
@ -1002,9 +1002,8 @@ For the last parameter only, instead of a type one may write
<code>...</code> or <code>... T</code> to indicate that the function <code>...</code> or <code>... T</code> to indicate that the function
may be invoked with zero or more additional arguments. If the type may be invoked with zero or more additional arguments. If the type
<code>T</code> is present in the parameter declaration, the additional <code>T</code> is present in the parameter declaration, the additional
arguments must all be arguments must all be <a href="#Assignability">assignable</a>
<a href="#Assignment_compatibility">assignment compatible</a> to <code>T</code>; otherwise they may be of any type.
with type <code>T</code>; otherwise they may be of any type.
</p> </p>
<pre> <pre>
@ -1322,11 +1321,11 @@ is different from <code>[]string</code>.
</p> </p>
<h3 id="Assignment_compatibility">Assignment compatibility</h3> <h3 id="Assignability">Assignability</h3>
<p> <p>
A value <code>x</code> is <i>assignment compatible</i> with type <code>T</code> A value <code>x</code> is <i>assignable</i> to a variable of type <code>T</code>
(<code>x</code> <i>can be assigned to</i> <code>T</code>) in any of these cases: ("<code>x</code> is assignable to <code>T</code>") in any of these cases:
</p> </p>
<ul> <ul>
@ -1550,7 +1549,7 @@ ExpressionList = Expression { "," Expression } .
<p> <p>
If the type is present, all constants take the type specified, and If the type is present, all constants take the type specified, and
the expressions must be <a href="#Assignment_compatibility">assignment compatible</a> with that type. the expressions must be <a href="#Assignability">assignable</a> to that type.
If the type is omitted, the constants take the If the type is omitted, the constants take the
individual types of the corresponding expressions. individual types of the corresponding expressions.
If the expression values are untyped <a href="#Constants">constants</a>, If the expression values are untyped <a href="#Constants">constants</a>,
@ -1993,8 +1992,8 @@ Value = Expression .
The LiteralType must be a struct, array, slice, or map type The LiteralType must be a struct, array, slice, or map type
(the grammar enforces this constraint except when the type is given (the grammar enforces this constraint except when the type is given
as a TypeName). as a TypeName).
The types of the expressions must be <a href="#Assignment_compatibility">assignment compatible</a> with The types of the expressions must be <a href="#Assignability">assignable</a>
the respective field, element, and key types of the LiteralType; to the respective field, element, and key types of the LiteralType;
there is no additional conversion. there is no additional conversion.
The key is interpreted as a field name for struct literals, The key is interpreted as a field name for struct literals,
an index expression for array and slice literals, and a key for map literals. an index expression for array and slice literals, and a key for map literals.
@ -2375,8 +2374,8 @@ where <code>M</code> is a <a href="#Map_types">map type</a>:
</p> </p>
<ul> <ul>
<li><code>x</code>'s type must be <li><code>x</code>'s type must be
<a href="#Assignment_compatibility">assignment compatible</a> <a href="#Assignability">assignable</a>
with the key type of <code>M</code></li> to the key type of <code>M</code></li>
<li>if the map contains an entry with key <code>x</code>, <li>if the map contains an entry with key <code>x</code>,
<code>a[x]</code> is the map value with key <code>x</code> <code>a[x]</code> is the map value with key <code>x</code>
and the type of <code>a[x]</code> is the value type of <code>M</code></li> and the type of <code>a[x]</code> is the value type of <code>M</code></li>
@ -2540,7 +2539,7 @@ f(a1, a2, ... an)
<p> <p>
calls <code>f</code> with arguments <code>a1, a2, ... an</code>. calls <code>f</code> with arguments <code>a1, a2, ... an</code>.
Except for one special case, arguments must be single-valued expressions Except for one special case, arguments must be single-valued expressions
<a href="#Assignment_compatibility">assignment compatible</a> with the parameter types of <a href="#Assignability">assignable</a> to the parameter types of
<code>F</code> and are evaluated before the function is called. <code>F</code> and are evaluated before the function is called.
The type of the expression is the result type The type of the expression is the result type
of <code>F</code>. of <code>F</code>.
@ -2557,8 +2556,8 @@ pt.Scale(3.5) // method call with receiver pt
<p> <p>
As a special case, if the return parameters of a function or method As a special case, if the return parameters of a function or method
<code>g</code> are equal in number and individually assignment <code>g</code> are equal in number and individually
compatible with the parameters of another function or method assignable to the parameters of another function or method
<code>f</code>, then the call <code>f(g(<i>parameters_of_g</i>))</code> <code>f</code>, then the call <code>f(g(<i>parameters_of_g</i>))</code>
will invoke <code>f</code> after binding the return values of will invoke <code>f</code> after binding the return values of
<code>g</code> to the parameters of <code>f</code> in order. The call <code>g</code> to the parameters of <code>f</code> in order. The call
@ -2702,8 +2701,8 @@ For operations involving constants only, see the section on
<p> <p>
In a channel send, the first operand is always a channel and the second In a channel send, the first operand is always a channel and the second
must be a value <a href="#Assignment_compatibility">assignment compatible</a> must be a value <a href="#Assignability">assignable</a>
with the channel's element type. to the channel's element type.
</p> </p>
<p> <p>
@ -2915,8 +2914,8 @@ Comparison operators compare two operands and yield a value of type <code>bool</
<p> <p>
The operands must be <i>comparable</i>; that is, the first operand The operands must be <i>comparable</i>; that is, the first operand
must be <a href="#Assignment_compatibility">assignment compatible</a> must be <a href="#Assignability">assignable</a>
with the type of the second operand, or vice versa. to the type of the second operand, or vice versa.
</p> </p>
<p> <p>
The operators <code>==</code> and <code>!=</code> apply The operators <code>==</code> and <code>!=</code> apply
@ -3258,7 +3257,7 @@ of these cases:
<ul> <ul>
<li> <li>
<code>x</code> can be <a href="#Assignment_compatibility">assigned</a> <code>x</code> is <a href="#Assignability">assignable</a>
to <code>T</code>. to <code>T</code>.
</li> </li>
<li> <li>
@ -3683,7 +3682,7 @@ a, b = b, a // exchange a and b
<p> <p>
In assignments, each value must be In assignments, each value must be
<a href="#Assignment_compatibility">assignment compatible</a> with the type of the <a href="#Assignability">assignable</a> to the type of the
operand to which it is assigned. If an untyped <a href="#Constants">constant</a> operand to which it is assigned. If an untyped <a href="#Constants">constant</a>
is assigned to a variable of interface type, the constant is <a href="#Conversions">converted</a> is assigned to a variable of interface type, the constant is <a href="#Conversions">converted</a>
to type <code>bool</code>, <code>int</code>, <code>float</code>, to type <code>bool</code>, <code>int</code>, <code>float</code>,
@ -3989,7 +3988,7 @@ map key, and the second variable, if present, is set to the corresponding
string or array element or map value. string or array element or map value.
The types of the array or slice index (always <code>int</code>) The types of the array or slice index (always <code>int</code>)
and element, or of the map key and value respectively, and element, or of the map key and value respectively,
must be <a href="#Assignment_compatibility">assignment compatible</a> with must be <a href="#Assignability">assignable</a> to
the type of the iteration variables. The expression on the right hand the type of the iteration variables. The expression on the right hand
side is evaluated once before beginning the loop. At each iteration side is evaluated once before beginning the loop. At each iteration
of the loop, the values produced by the range clause are assigned to of the loop, the values produced by the range clause are assigned to
@ -4033,7 +4032,7 @@ for i, s := range a {
} }
var key string var key string
var val interface {} // value type of m is assignment compatible with val var val interface {} // value type of m is assignable to val
for key, val = range m { for key, val = range m {
h(key, val) h(key, val)
} }
@ -4165,9 +4164,8 @@ type:
<ol> <ol>
<li>The return value or values may be explicitly listed <li>The return value or values may be explicitly listed
in the "return" statement. Each expression must be single-valued in the "return" statement. Each expression must be single-valued
and <a href="#Assignment_compatibility">assignment compatible</a> and <a href="#Assignability">assignable</a>
with the type of the corresponding element of the function's to the corresponding element of the function's result type.
result type.
<pre> <pre>
func simple_f() int { func simple_f() int {
return 2 return 2
@ -4494,7 +4492,7 @@ The built-in function <code>copy</code> copies slice elements from
a source <code>src</code> to a destination <code>dst</code> and returns the a source <code>src</code> to a destination <code>dst</code> and returns the
number of elements copied. Source and destination may overlap. number of elements copied. Source and destination may overlap.
Both arguments must have <a href="#Type_identity">identical</a> element type <code>T</code> and must be Both arguments must have <a href="#Type_identity">identical</a> element type <code>T</code> and must be
<a href="#Assignment_compatibility">assignment compatible</a> to a slice <a href="#Assignability">assignable</a> to a slice
of type <code>[]T</code>. The number of arguments copied is the minimum of of type <code>[]T</code>. The number of arguments copied is the minimum of
<code>len(src)</code> and <code>len(dst)</code>. <code>len(src)</code> and <code>len(dst)</code>.
</p> </p>