ci: generate pages at efd044a [ci skip]

Author: tatsuya6502

public/1.9/book/references-and-borrowing.html

@@ -227,14 +227,15 @@ <h1 id='概論' class='section-header'><a href='#概論'>概論</a></h1>
 
 <!-- as possible in order to make them work. The ownership system is a prime example -->
 
-<!-- of a zero cost abstraction. All of the analysis we’ll talk about in this guide -->
+<!-- of a zero-cost abstraction. All of the analysis we’ll talk about in this guide -->
 
 <!-- is _done at compile time_. You do not pay any run-time cost for any of these -->
 
 <!-- features. -->
 
 <p>Rustは安全性とスピートに焦点を合わせます。
-Rustはそれらの目標をたくさんの「ゼロコスト抽象化」を通じて成し遂げます。それは、Rustでは抽象化を機能させるためのコストをできる限り小さくすることを意味します。
+Rustはそれらの目標を、様々な「ゼロコスト抽象化」を通じて成し遂げます。
+それは、Rustでは抽象化を機能させるためのコストをできる限り小さくすることを意味します。
 所有権システムはゼロコスト抽象化の主な例です。
 このガイドの中で話すであろう解析の全ては <em>コンパイル時に行われます</em> 。
 それらのどの機能に対しても実行時のコストは全く掛かりません。</p>
@@ -258,9 +259,11 @@ <h1 id='概論' class='section-header'><a href='#概論'>概論</a></h1>
 <!-- checker less and less. -->
 
 <p>しかし、このシステムはあるコストを持ちます。それは学習曲線です。
-多くの新しいRustのユーザは「借用チェッカとの戦い」と好んで呼ばれるものを経験します。そこではRustコンパイラが開発者が正しいと考えるプログラムをコンパイルすることを拒絶します。
+多くのRust入門者は、私たちが「借用チェッカとの戦い」と呼ぶものを経験します。
+そこではRustコンパイラが、開発者が正しいと考えるプログラムをコンパイルすることを拒絶します。
 所有権がどのように機能するのかについてのプログラマのメンタルモデルがRustの実装する実際のルールにマッチしないため、これはしばしば起きます。
-しかし、よいニュースがあります。より経験豊富なRustの開発者は次のことを報告します。一度彼らが所有権システムのルールとともにしばらく仕事をすれば、彼らが借用チェッカと戦うことは少なくなっていくということです。</p>
+しかし、よいニュースがあります。より経験豊富なRustの開発者は次のことを報告します。
+それは、所有権システムのルールと共にしばらく仕事をすれば、借用チェッカと戦うことは次第に少なくなっていく、というものです。</p>
 
 <!-- With that in mind, let’s learn about borrowing. -->
 
@@ -359,11 +362,11 @@ <h1 id='借用' class='section-header'><a href='#借用'>借用</a></h1>
 何かを借用した束縛はそれがスコープから外れるときにリソースを割当解除しません。
 これは <code>foo()</code> の呼出しの後に元の束縛を再び使うことができることを意味します。</p>
 
-<!-- References are immutable, just like bindings. This means that inside of `foo()`, -->
+<!-- References are immutable, like bindings. This means that inside of `foo()`, -->
 
 <!-- the vectors can’t be changed at all: -->
 
-<p>参照は束縛とちょうど同じようにイミュータブルです。
+<p>参照は束縛と同じようにイミュータブルです。
 これは <code>foo()</code> の中ではベクタは全く変更できないことを意味します。</p>
 
 <span class='rusttest'>fn main() {
@@ -404,7 +407,7 @@ <h1 id='mut参照' class='section-header'><a href='#mut参照'>&amp;mut参照</a
 <!-- to mutate the resource you’re borrowing. For example: -->
 
 <p>参照には2つ目の種類、 <code>&amp;mut T</code> があります。
-「ミュータブルな参照」によって借用しているリソースを変更することができるようになります。
+「ミュータブルな参照」によって借用しているリソースを変更できるようになります。
 例は次のとおりです。</p>
 
 <span class='rusttest'>fn main() {
@@ -428,29 +431,29 @@ <h1 id='mut参照' class='section-header'><a href='#mut参照'>&amp;mut参照</a
 
 <!-- If it wasn’t, we couldn’t take a mutable borrow to an immutable value. -->
 
-<p>これは <code>6</code> をプリントするでしょう。
+<p>これは <code>6</code> を表示するでしょう。
 <code>y</code> を <code>x</code> へのミュータブルな参照にして、それから <code>y</code> の指示先に1を足します。
 <code>x</code> も <code>mut</code> とマークしなければならないことに気付くでしょう。
 そうしないと、イミュータブルな値へのミュータブルな借用ということになってしまい、使うことができなくなってしまいます。</p>
 
 <!-- You'll also notice we added an asterisk (`*`) in front of `y`, making it `*y`, -->
 
-<!-- this is because `y` is an `&mut` reference. You'll also need to use them for -->
+<!-- this is because `y` is a `&mut` reference. You'll also need to use them for -->
 
 <!-- accessing the contents of a reference as well. -->
 
 <p>アスタリスク（ <code>*</code> ）を <code>y</code> の前に追加して、それを <code>*y</code> にしたことにも気付くでしょう。これは、 <code>y</code> が <code>&amp;mut</code> 参照だからです。
 参照の内容にアクセスするためにもそれらを使う必要があるでしょう。</p>
 
-<!-- Otherwise, `&mut` references are just like references. There _is_ a large -->
+<!-- Otherwise, `&mut` references are like references. There _is_ a large -->
 
 <!-- difference between the two, and how they interact, though. You can tell -->
 
 <!-- something is fishy in the above example, because we need that extra scope, with -->
 
 <!-- the `{` and `}`. If we remove them, we get an error: -->
 
-<p>それ以外は、 <code>&amp;mut</code> 参照は普通の参照と全く同じです。
+<p>それ以外は、 <code>&amp;mut</code> 参照は普通の参照と同じです。
 しかし、2つの間には、そしてそれらがどのように相互作用するかには大きな違いが <em>あります</em> 。
 前の例で何かが怪しいと思ったかもしれません。なぜなら、 <code>{</code> と <code>}</code> を使って追加のスコープを必要とするからです。
 もしそれらを削除すれば、次のようなエラーが出ます。</p>
@@ -498,9 +501,9 @@ <h1 id='ルール' class='section-header'><a href='#ルール'>ルール</a></h1
 <li>ただ1つのミュータブルな参照（ <code>&amp;mut T</code> ）</li>
 </ul>
 
-<!-- You may notice that this is very similar, though not exactly the same as, -->
+<!-- You may notice that this is very similar to, though not exactly the same as, -->
 
-<!-- to the definition of a data race: -->
+<!-- the definition of a data race: -->
 
 <p>これがデータ競合の定義と非常に似ていることに気付くかもしれません。全く同じではありませんが。</p>
 
@@ -580,14 +583,17 @@ <h2 id='スコープの考え方' class='section-header'><a href='#スコープ
 
 <!-- In other words, the mutable borrow is held through the rest of our example. What -->
 
-<!-- we want is for the mutable borrow to end _before_ we try to call `println!` and -->
+<!-- we want is for the mutable borrow by `y` to end so that the resource can be -->
 
-<!-- make an immutable borrow. In Rust, borrowing is tied to the scope that the -->
+<!-- returned to the owner, `x`. `x` can then provide a immutable borrow to `println!`. -->
 
-<!-- borrow is valid for. And our scopes look like this: -->
+<!-- In Rust, borrowing is tied to the scope that the borrow is valid for. And our -->
 
-<p>言い換えると、ミュータブルな借用は先程の例の残りの間ずっと保持されるということです。
-必要なものは、 <code>println!</code> を呼び出し、イミュータブルな借用を作ろうとする <em>前に</em> 終わるミュータブルな借用です。
+<!-- scopes look like this: -->
+
+<p>言い換えると、ミュータブルな借用は、先ほどの例の残りの間、ずっと保持されるということです。
+ここで私たちが求めているのは、<code>y</code> によるミュータブルな借用が終わり、リソースがその所有者である <code>x</code> に返却されることです。
+そうすれば <code>x</code> は <code>println!</code> にイミュータブルな借用を提供できるわけです。
 Rustでは借用はその有効なスコープと結び付けられます。
 そしてスコープはこのように見えます。</p>
 
@@ -651,9 +657,9 @@ <h2 id='スコープの考え方' class='section-header'><a href='#スコープ
 
 <!-- immutable one. But scope is the key to seeing how long a borrow lasts for. -->
 
-<p>問題ありません。
+<p>これなら問題ありません。
 ミュータブルな借用はイミュータブルな借用を作る前にスコープから外れます。
-しかしスコープは借用がどれくらい存続するのか理解するための鍵となります。</p>
+しかしスコープは、借用がどれくらい存続するのか理解するための鍵となります。</p>
 
 <!-- ## Issues borrowing prevents -->
 
@@ -692,13 +698,13 @@ <h3 id='イテレータの無効' class='section-header'><a href='#イテレー
     <span class='macro'>println</span><span class='macro'>!</span>(<span class='string'>&quot;{}&quot;</span>, <span class='ident'>i</span>);
 }</pre>
 
-<!-- This prints out one through three. As we iterate through the vectors, we’re -->
+<!-- This prints out one through three. As we iterate through the vector, we’re -->
 
 <!-- only given references to the elements. And `v` is itself borrowed as immutable, -->
 
 <!-- which means we can’t change it while we’re iterating: -->
 
-<p>これは1から3までをプリントアウトします。
+<p>これは1から3までを表示します。
 ベクタに対して繰り返すとき、要素への参照だけを受け取ります。
 そして、 <code>v</code> はそれ自体イミュータブルとして借用され、それは繰返しを行っている間はそれを変更できないことを意味します。</p>