ci: generate pages at 39ab0de [ci skip]

Author: bn-e

docs/ch03-01-variables-and-mutability.html

@@ -179,9 +179,9 @@ <h2 id="変数と可変性"><a class="header" href="#変数と可変性">変数
 <span class="filename">Filename: src/main.rs</span>
 -->
 <p><span class="filename">ファイル名: src/main.rs</span></p>
-<pre><code class="language-rust ignore">fn main() {
+<pre><code class="language-rust ignore does_not_compile">fn main() {
     let x = 5;
-    println!(&quot;The value of x is: {}&quot;, x);     // xの値は{}です
+    println!(&quot;The value of x is: {}&quot;, x);;     // xの値は{}です
     x = 6;
     println!(&quot;The value of x is: {}&quot;, x);
 }
@@ -191,16 +191,24 @@ <h2 id="変数と可変性"><a class="header" href="#変数と可変性">変数
 message, as shown in this output:
 -->
 <p>これを保存し、<code>cargo run</code>コマンドでプログラムを走らせてください。次の出力に示されているようなエラーメッセージを受け取るはずです:</p>
-<pre><code class="language-text">error[E0384]: cannot assgin twice immutable variable `x`
+<pre><code class="language-console">$ cargo run
+   Compiling variables v0.1.0 (file:///projects/variables)
+error[E0384]: cannot assign twice to immutable variable `x`
               (不変変数`x`に2回代入できません)
  --&gt; src/main.rs:4:5
   |
 2 |     let x = 5;
-  |         - first assignment to `x`
+  |         -
+  |         |
+  |         first assignment to `x`
   |         (`x`への最初の代入)
+  |         help: consider making this binding mutable: `mut x`
 3 |     println!(&quot;The value of x is: {}&quot;, x);
 4 |     x = 6;
   |     ^^^^^ cannot assign twice to immutable variable
+
+For more information about this error, try `rustc --explain E0384`.
+error: could not compile `variables` due to previous error
 </code></pre>
 <!--
 This example shows how the compiler helps you find errors in your programs.
@@ -270,9 +278,9 @@ <h2 id="変数と可変性"><a class="header" href="#変数と可変性">変数
 When we run the program now, we get this:
 -->
 <p>今、このプログラムを走らせると、以下のような出力が得られます:</p>
-<pre><code class="language-text">$ cargo run
+<pre><code class="language-console">$ cargo run
    Compiling variables v0.1.0 (file:///projects/variables)
-    Finished dev [unoptimized + debuginfo] target(s) in 0.30 secs
+    Finished dev [unoptimized + debuginfo] target(s) in 0.30s
      Running `target/debug/variables`
 The value of x is: 5   (xの値は5です)
 The value of x is: 6
@@ -394,27 +402,33 @@ <h3 id="シャドーイング"><a class="header" href="#シャドーイング">
 
     let x = x + 1;
 
-    let x = x * 2;
+    {
+        let x = x * 2;
+        println!(&quot;The value of x in the inner scope is: {}&quot;, x);
+    }
 
     println!(&quot;The value of x is: {}&quot;, x);
 }
 </code></pre></pre>
 <!--
 This program first binds `x` to a value of `5`. Then it shadows `x` by
 repeating `let x =`, taking the original value and adding `1` so the value of
-`x` is then `6`. The third `let` statement also shadows `x`, multiplying the
-previous value by `2` to give `x` a final value of `12`. Wehn we run this
-program, it will output the following:
+`x` is then `6`. Then, within an inner scope, the third `let` statement also
+shadows `x`, multiplying the previous value by `2` to give `x` a value of `12`.
+When that scope is over, the inner shadowing ends and `x` returns to being `6`.
+When we run this program, it will output the following:
 -->
 <p>このプログラムはまず、<code>x</code>を<code>5</code>という値に束縛します。それから<code>let x =</code>を繰り返すことで<code>x</code>を覆い隠し、
 元の値に<code>1</code>を加えることになるので、<code>x</code>の値は<code>6</code>になります。
 3番目の<code>let</code>文も<code>x</code>を覆い隠し、以前の値に<code>2</code>をかけることになるので、<code>x</code>の最終的な値は<code>12</code>になります。
+括弧を抜けるとシャドーイングは終了し、<code>x</code>の値は元の<code>6</code>に戻ります。
 このプログラムを走らせたら、以下のように出力するでしょう:</p>
-<pre><code class="language-text">$ cargo run
+<pre><code class="language-console">$ cargo run
    Compiling variables v0.1.0 (file:///projects/variables)
-    Finished dev [unoptimized + debuginfo] target(s) in 0.31 secs
+    Finished dev [unoptimized + debuginfo] target(s) in 0.31s
      Running `target/debug/variables`
-The value of x is: 12
+The value of x in the inner scope is: 12
+The value of x is: 6
 </code></pre>
 <!--
 Shadowing is different than marking a variable as `mut`, because we’ll get a
@@ -437,11 +451,9 @@ <h3 id="シャドーイング"><a class="header" href="#シャドーイング">
 値の型を変えつつ、同じ変数名を使いまわせることです。例えば、
 プログラムがユーザに何らかのテキストに対して空白文字を入力することで何個分のスペースを表示したいかを尋ねますが、
 ただ、実際にはこの入力を数値として保持したいとしましょう:</p>
-<pre><pre class="playground"><code class="language-rust">
-<span class="boring">#![allow(unused)]
-</span><span class="boring">fn main() {
-</span>let spaces = &quot;   &quot;;
-let spaces = spaces.len();
+<pre><pre class="playground"><code class="language-rust"><span class="boring">fn main() {
+</span>    let spaces = &quot;   &quot;;
+    let spaces = spaces.len();
 <span class="boring">}
 </span></code></pre></pre>
 <!--
@@ -457,23 +469,29 @@ <h3 id="シャドーイング"><a class="header" href="#シャドーイング">
 異なる名前を思いつく必要がなくなるわけです。<code>spaces_str</code>と<code>spaces_num</code>などですね; 代わりに、
 よりシンプルな<code>spaces</code>という名前を再利用できるわけです。一方で、この場合に<code>mut</code>を使おうとすると、
 以下に示した通りですが、コンパイルエラーになるわけです:</p>
-<pre><code class="language-rust ignore">let mut spaces = &quot;   &quot;;
-spaces = spaces.len();
-</code></pre>
+<pre><code class="language-rust ignore does_not_compile"><span class="boring">fn main() {
+</span>    let mut spaces = &quot;   &quot;;
+    spaces = spaces.len();
+<span class="boring">}
+</span></code></pre>
 <!--
 The error says we’re not allowed to mutate a variable’s
 type:
 -->
 <p>変数の型を可変にすることは許されていないと言われているわけです:</p>
-<pre><code class="language-text">error[E0308]: mismatched types          (型が合いません)
+<pre><code class="language-console">$ cargo run
+   Compiling variables v0.1.0 (file:///projects/variables)
+error[E0308]: mismatched types          (型が合いません)
  --&gt; src/main.rs:3:14
   |
+2 |     let mut spaces = &quot;   &quot;;
+  |                      ----- expected due to this value
 3 |     spaces = spaces.len();
-  |              ^^^^^^^^^^^^ expected &amp;str, found usize
+  |              ^^^^^^^^^^^^ expected `&amp;str`, found `usize`
   |                           (&amp;str型を予期しましたが、usizeが見つかりました)
-  |
-  = note: expected type `&amp;str`
-             found type `usize`
+
+For more information about this error, try `rustc --explain E0308`.
+error: could not compile `variables` due to previous error
 </code></pre>
 <!--
 Now that we’ve explored how variables work, let’s look at more data types they

docs/ch03-02-data-types.html

@@ -182,16 +182,18 @@ <h2 id="データ型"><a class="header" href="#データ型">データ型</a></h
 -->
 <p>ここで型注釈を付けなければ、コンパイラは以下のエラーを表示し、これは可能性のある型のうち、
 どの型を使用したいのかを知るのに、コンパイラがプログラマからもっと情報を得る必要があることを意味します:</p>
-<pre><code class="language-text">error[E0282]: type annotations needed
+<pre><code class="language-console">$ cargo build
+   Compiling no_type_annotations v0.1.0 (file:///projects/no_type_annotations)
+error[E0282]: type annotations needed
               (型注釈が必要です)
  --&gt; src/main.rs:2:9
   |
 2 |     let guess = &quot;42&quot;.parse().expect(&quot;Not a number!&quot;);
-  |         ^^^^^ cannot infer type for `_`
-  |               (`_`の型が推論できません)
-  |
-  = note: type annotations or generic parameter binding required
-    (注釈: 型注釈、またはジェネリクス引数束縛が必要です)
+  |         ^^^^^ consider giving `guess` a type
+  |               (`guess`に型を与えることを検討してください)
+
+For more information about this error, try `rustc --explain E0282`.
+error: could not compile `no_type_annotations` due to previous error
 </code></pre>
 <!--
 You’ll see different type annotations for other data types.
@@ -369,39 +371,26 @@ <h4 id="数値演算"><a class="header" href="#数値演算">数値演算</a></h
 <span class="filename">Filename: src/main.rs</span>
 -->
 <p><span class="filename">ファイル名: src/main.rs</span></p>
-<!--
-```rust
-fn main() {
-// addition
-let sum = 5 + 10;
-
-// subtraction
-let difference = 95.5 - 4.3;
-
-// multiplication
-let product = 4 * 30;
-
-// division
-let quotient = 56.7 / 32.2;
-
-// remainder
-let remainder = 43 % 5;
-}
-```
--->
 <pre><pre class="playground"><code class="language-rust">fn main() {
+    // addition
     // 足し算
     let sum = 5 + 10;
 
+    // subtraction
     // 引き算
     let difference = 95.5 - 4.3;
 
+    // multiplication
     // 掛け算
     let product = 4 * 30;
 
+    // division
     // 割り算
     let quotient = 56.7 / 32.2;
+    let floored = 2 / 3; // Results in 0
+                         // 結果は0
 
+    // remainder
     // 余り
     let remainder = 43 % 5;
 }
@@ -429,18 +418,11 @@ <h4 id="論理値型"><a class="header" href="#論理値型">論理値型</a></h
 <span class="filename">Filename: src/main.rs</span>
 -->
 <p><span class="filename">ファイル名: src/main.rs</span></p>
-<!--
-```rust
-fn main() {
-let t = true;
-let f: bool = false; // with explicit type annotation
-}
-```
--->
 <pre><pre class="playground"><code class="language-rust">fn main() {
     let t = true;
 
-    let f: bool = false; // 明示的型注釈付きで
+    let f: bool = false; // with explicit type annotation
+                         // 明示的型注釈付きで
 }
 </code></pre></pre>
 <!--
@@ -637,6 +619,40 @@ <h4 id="配列型"><a class="header" href="#配列型">配列型</a></h4>
 <span class="boring">}
 </span></code></pre></pre>
 <!--
+You write an array’s type using square brackets with the type of each element,
+a semicolon, and then the number of elements in the array, like so:
+-->
+<p>例えば次のように、配列の型は角かっこの中に要素の型とセミコロン、そして配列の要素数を与えます。</p>
+<pre><pre class="playground"><code class="language-rust">
+<span class="boring">#![allow(unused)]
+</span><span class="boring">fn main() {
+</span>let a: [i32; 5] = [1, 2, 3, 4, 5];
+<span class="boring">}
+</span></code></pre></pre>
+<!--
+Here, `i32` is the type of each element. After the semicolon, the number `5`
+indicates the array contains five elements.
+-->
+<p>ここでの<code>i32</code>は要素の型です。セミコロンのあとの<code>5</code>という数字は配列の要素が5つあることを表しています。</p>
+<!--
+You can also initialize an array to contain the same value for each element by
+specifying the initial value, followed by a semicolon, and then the length of
+the array in square brackets, as shown here:
+-->
+<p>次のように、角かっこの中に初期値とセミコロン、そして配列の長さを与えることで、各要素に同じ値を持つように配列を初期化することができます。</p>
+<pre><pre class="playground"><code class="language-rust">
+<span class="boring">#![allow(unused)]
+</span><span class="boring">fn main() {
+</span>let a = [3; 5];
+<span class="boring">}
+</span></code></pre></pre>
+<!--
+The array named `a` will contain `5` elements that will all be set to the value
+`3` initially. This is the same as writing `let a = [3, 3, 3, 3, 3];` but in a
+more concise way.
+-->
+<p>この<code>a</code>という名前の配列は<code>3</code>という値が5つあるものです。これは<code>let a = [3, 3, 3, 3, 3];</code>と書くのと同じですが、より簡潔になります。</p>
+<!--
 ##### Accessing Array Elements
 -->
 <h5 id="配列の要素にアクセスする"><a class="header" href="#配列の要素にアクセスする">配列の要素にアクセスする</a></h5>
@@ -679,28 +695,52 @@ <h5 id="配列要素への無効なアクセス"><a class="header" href="#配列
 <span class="filename">Filename: src/main.rs</span>
 -->
 <p><span class="filename">ファイル名: src/main.rs</span></p>
-<pre><code class="language-rust ignore">fn main() {
+<pre><code class="language-rust ignore panics">use std::io;
+
+fn main() {
     let a = [1, 2, 3, 4, 5];
-    let index = 10;
+
+    println!(&quot;Please enter an array index.&quot;);
+           // 配列の何番目の要素にアクセスするか指定してください
+
+    let mut index = String::new();
+
+    io::stdin()
+        .read_line(&amp;mut index)
+        .expect(&quot;Failed to read line&quot;);
+              // 値の読み込みに失敗しました
+
+    let index: usize = index
+        .trim()
+        .parse()
+        .expect(&quot;Index entered was not a number&quot;);
+        　　　// 入力された値は数字ではありません
 
     let element = a[index];
 
-    println!(&quot;The value of element is: {}&quot;, element);   // 要素の値は{}です
+    println!(
+        &quot;The value of the element at index {} is: {}&quot;,
+        // {}番目の要素の値は{}です
+        index, element
+    );
 }
 </code></pre>
 <!--
-Running this code using `cargo run` produces the following result:
+This code compiles successfully. If you run this code using `cargo run` and
+enter 0, 1, 2, 3, or 4, the program will print out the corresponding value at
+that index in the array. If you instead enter a number past the end of the
+array, such as 10, you’ll see output like this:
+-->
+<p>このコードはコンパイルされます。<code>cargo run</code>で走らせ、0, 1, 2, 3, または4をこのプログラムに入力すると配列の対応する値を出力します。もし配列の末尾を超えるような、例えば10などの数字を与えると、次のような出力が表示されます。</p>
+<!-- manual-regeneration
+cd listings/ch03-common-programming-concepts/no-listing-15-invalid-array-access
+cargo run
+10
 -->
-<p>このコードを<code>cargo run</code>で走らせると、以下のような結果になります:</p>
-<pre><code class="language-text">$ cargo run
-   Compiling arrays v0.1.0 (file:///projects/arrays)
-    Finished dev [unoptimized + debuginfo] target(s) in 0.31 secs
-     Running `target/debug/arrays`
-thread '&lt;main&gt;' panicked at 'index out of bounds: the len is 5 but the index is
- 10', src/main.rs:6
-スレッド'&lt;main&gt;'は'範囲外アクセス: 長さは5ですが、添え字は10でした', src/main.rs:6
+<pre><code class="language-console">thread 'main' panicked at 'index out of bounds: the len is 5 but the index is 10', src/main.rs:19:19
+スレッド'main'は'範囲外アクセス: 長さは5ですが、添え字は10でした', src/main.rs:19:19
 でパニックしました
-note: Run with `RUST_BACKTRACE=1` for a backtrace.
+note: run with `RUST_BACKTRACE=1` environment variable to display a backtrace
 </code></pre>
 <!--
 The compilation didn’t produce any errors, but the program results in a