mirror of
https://github.com/golang/go
synced 2024-11-25 02:07:58 -07:00
doc fixes (no lang changes)
- added missing predeclared identifiers - html-escaping of a few <<'s and >>'s - added a few links (and removed the §'s) R=r DELTA=30 (0 added, 0 deleted, 30 changed) OCL=33985 CL=33995
This commit is contained in:
parent
1f95f0d353
commit
4ed666e228
@ -191,8 +191,8 @@ The following character sequences represent operators, delimiters, and other spe
|
||||
+ & += &= && == != ( )
|
||||
- | -= |= || < <= [ ]
|
||||
* ^ *= ^= <- > >= { }
|
||||
/ << /= <<= ++ = := , ;
|
||||
% >> %= >>= -- ! ... . :
|
||||
/ << /= <<= ++ = := , ;
|
||||
% >> %= >>= -- ! ... . :
|
||||
&^ &^=
|
||||
</pre>
|
||||
|
||||
@ -570,8 +570,8 @@ ElementType = Type .
|
||||
</pre>
|
||||
|
||||
<p>
|
||||
The length is part of the array's type and must must be a constant
|
||||
expression (§<a href="#Constant_expressions">Constant expressions</a>) that evaluates to a non-negative
|
||||
The length is part of the array's type and must must be a
|
||||
<a href="#Constant_expressions">constant expression</a> that evaluates to a non-negative
|
||||
integer value. The length of array <code>a</code> can be discovered
|
||||
using the built-in function <code>len(a)</code>, which is a
|
||||
compile-time constant. The elements can be indexed by integer
|
||||
@ -881,7 +881,7 @@ interface { }
|
||||
|
||||
<p>
|
||||
Similarly, consider this interface specification,
|
||||
which appears within a type declaration (§<a href="#Type_declarations">Type declarations</a>)
|
||||
which appears within a <a href="#Type_declarations">type declaration</a>
|
||||
to define an interface called <code>Lock</code>:
|
||||
</p>
|
||||
|
||||
@ -1351,7 +1351,7 @@ Constants:
|
||||
true false iota nil
|
||||
|
||||
Functions:
|
||||
cap len make new panic panicln print println
|
||||
cap close closed len make new panic panicln print println
|
||||
|
||||
Packages:
|
||||
unsafe
|
||||
@ -1458,9 +1458,9 @@ const ( // iota is reset to 0
|
||||
)
|
||||
|
||||
const (
|
||||
a = 1 << iota; // a == 1 (iota has been reset)
|
||||
b = 1 << iota; // b == 2
|
||||
c = 1 << iota; // c == 4
|
||||
a = 1 << iota; // a == 1 (iota has been reset)
|
||||
b = 1 << iota; // b == 2
|
||||
c = 1 << iota; // c == 4
|
||||
)
|
||||
|
||||
const (
|
||||
@ -1480,7 +1480,7 @@ it is only incremented at a semicolon:
|
||||
|
||||
<pre>
|
||||
const (
|
||||
bit0, mask0 = 1 << iota, 1 << iota - 1; // bit0 == 1, mask0 == 0
|
||||
bit0, mask0 = 1 << iota, 1 << iota - 1; // bit0 == 1, mask0 == 0
|
||||
bit1, mask1; // bit1 == 2, mask1 == 1
|
||||
bit2, mask2; // bit2 == 4, mask2 == 3
|
||||
)
|
||||
@ -1781,7 +1781,7 @@ Value = Expression .
|
||||
The LiteralType must be a struct, array, slice, or map type
|
||||
(the grammar enforces this constraint except when the type is given
|
||||
as a TypeName).
|
||||
The types of the expressions must be assignment compatible to
|
||||
The types of the expressions must be <a href="#Assignment_compatibility">assignment compatible</a> to
|
||||
the respective field, element, and key types of the LiteralType;
|
||||
there is no additional conversion.
|
||||
The key is interpreted as a field name for struct literals,
|
||||
@ -2297,7 +2297,7 @@ f(a1, a2, ... an)
|
||||
<p>
|
||||
calls <code>f</code> with arguments <code>a1, a2, ... an</code>.
|
||||
The arguments must be single-valued expressions
|
||||
assignment compatible with the parameters of
|
||||
<a href="#Assignment_compatibility">assignment compatible</a> with the parameters of
|
||||
<code>F</code> and are evaluated before the function is called.
|
||||
The type of the expression is the result type
|
||||
of <code>F</code>.
|
||||
@ -2389,7 +2389,7 @@ log_op = "||" | "&&" .
|
||||
com_op = "<-" .
|
||||
rel_op = "==" | "!=" | "<" | "<=" | ">" | ">=" .
|
||||
add_op = "+" | "-" | "|" | "^" .
|
||||
mul_op = "*" | "/" | "%" | "<<" | ">>" | "&" | "&^" .
|
||||
mul_op = "*" | "/" | "%" | "<<" | ">>" | "&" | "&^" .
|
||||
|
||||
unary_op = "+" | "-" | "!" | "^" | "*" | "&" | "<-" .
|
||||
</pre>
|
||||
@ -2455,7 +2455,7 @@ operators, comparison operators, communication operators,
|
||||
|
||||
<pre class="grammar">
|
||||
Precedence Operator
|
||||
6 * / % << >> & &^
|
||||
6 * / % << >> & &^
|
||||
5 + - | ^
|
||||
4 == != < <= > >=
|
||||
3 <-
|
||||
@ -2475,7 +2475,7 @@ Examples:
|
||||
+x
|
||||
23 + 3*x[i]
|
||||
x <= f()
|
||||
^a >> b
|
||||
^a >> b
|
||||
f() || g()
|
||||
x == y + 1 && <-chan_ptr > 0
|
||||
</pre>
|
||||
@ -2502,8 +2502,8 @@ to strings; all other arithmetic operators apply to integers only.
|
||||
^ bitwise xor integers
|
||||
&^ bit clear (and not) integers
|
||||
|
||||
<< left shift integer << unsigned integer
|
||||
>> right shift integer >> unsigned integer
|
||||
<< left shift integer << unsigned integer
|
||||
>> right shift integer >> unsigned integer
|
||||
</pre>
|
||||
|
||||
<p>
|
||||
@ -2547,7 +2547,7 @@ be replaced by a bitwise "and" operation:
|
||||
</p>
|
||||
|
||||
<pre>
|
||||
x x / 4 x % 4 x >> 2 x & 3
|
||||
x x / 4 x % 4 x >> 2 x & 3
|
||||
11 2 3 2 3
|
||||
-11 -2 -3 -3 1
|
||||
</pre>
|
||||
@ -2559,8 +2559,8 @@ integer and logical shifts if it is an unsigned integer. The shift count must
|
||||
be an unsigned integer. There is no upper limit on the shift count. Shifts behave
|
||||
as if the left operand is shifted <code>n</code> times by 1 for a shift
|
||||
count of <code>n</code>.
|
||||
As a result, <code>x << 1</code> is the same as <code>x*2</code>
|
||||
and <code>x >> 1</code> is the same as
|
||||
As a result, <code>x << 1</code> is the same as <code>x*2</code>
|
||||
and <code>x >> 1</code> is the same as
|
||||
<code>x/2</code> truncated towards negative infinity.
|
||||
</p>
|
||||
|
||||
@ -2913,8 +2913,8 @@ in the language. The following are legal declarations:
|
||||
</p>
|
||||
|
||||
<pre>
|
||||
const Huge = 1 << 100;
|
||||
const Four int8 = Huge >> 98;
|
||||
const Huge = 1 << 100;
|
||||
const Four int8 = Huge >> 98;
|
||||
</pre>
|
||||
|
||||
<p>
|
||||
@ -3122,7 +3122,7 @@ only once. The <i>op</i><code>=</code> construct is a single token.
|
||||
</p>
|
||||
|
||||
<pre>
|
||||
a[i] <<= 2
|
||||
a[i] <<= 2
|
||||
</pre>
|
||||
|
||||
<p>
|
||||
@ -3159,8 +3159,8 @@ a, b = b, a // exchange a and b
|
||||
</pre>
|
||||
|
||||
<p>
|
||||
In assignments, the type of each value must be assignment compatible
|
||||
(§<a href="#Assignment_compatibility">Assignment compatibility</a>) with the type of the
|
||||
In assignments, the type of each value must be
|
||||
<a href="#Assignment_compatibility">assignment compatible</a> with the type of the
|
||||
operand to which it is assigned.
|
||||
</p>
|
||||
|
||||
@ -3402,7 +3402,7 @@ A "for" statement with a "for" clause is also controlled by its condition, but
|
||||
additionally it may specify an <i>init</i>
|
||||
and a <i>post</i> statement, such as an assignment,
|
||||
an increment or decrement statement. The init statement may be a
|
||||
short variable declaration, but the post statement must not.
|
||||
<a href="#Short_variable_declarations">short variable declaration</a>, but the post statement must not.
|
||||
</p>
|
||||
|
||||
<pre class="ebnf">
|
||||
@ -3460,7 +3460,7 @@ map key, and the second variable, if present, is set to the corresponding
|
||||
string or array element or map value.
|
||||
The types of the array or slice index (always <code>int</code>)
|
||||
and element, or of the map key and value respectively,
|
||||
must be assignment compatible to the iteration variables.
|
||||
must be <a href="#Assignment_compatibility">assignment compatible</a> to the iteration variables.
|
||||
</p>
|
||||
<p>
|
||||
For strings, the "range" clause iterates over the Unicode code points
|
||||
@ -3575,8 +3575,8 @@ in the "select" statement.
|
||||
If multiple cases can proceed, a uniform fair choice is made to decide
|
||||
which single communication will execute.
|
||||
<p>
|
||||
The receive case may declare a new variable using a short variable declaration
|
||||
(§<a href="#Short_variable_declarations">Short variable declarations</a>).
|
||||
The receive case may declare a new variable using a
|
||||
<a href="#Short_variable_declarations">short variable declaration</a>.
|
||||
</p>
|
||||
|
||||
<pre>
|
||||
@ -3633,7 +3633,7 @@ type:
|
||||
<ol>
|
||||
<li>The return value or values may be explicitly listed
|
||||
in the "return" statement. Each expression must be single-valued
|
||||
and assignment-compatible to the corresponding element of
|
||||
and <a href="#Assignment_compatibility">assignment compatible</a> to the corresponding element of
|
||||
the result type of the function.
|
||||
<pre>
|
||||
func simple_f() int {
|
||||
|
Loading…
Reference in New Issue
Block a user