Merge branch 'master' into variable-bindings

Author: KeenS

1.6/ja/book/box-syntax-and-patterns.md

@@ -1,9 +1,11 @@
-%  Box Syntax and Patterns
+% Box構文とパターン
+<!-- %  Box Syntax and Patterns -->
 
-Currently the only stable way to create a `Box` is via the `Box::new` method.
-Also it is not possible in stable Rust to destructure a `Box` in a match
-pattern. The unstable `box` keyword can be used to both create and destructure
-a `Box`. An example usage would be:
+<!-- Currently the only stable way to create a `Box` is via the `Box::new` method. -->
+<!-- Also it is not possible in stable Rust to destructure a `Box` in a match -->
+<!-- pattern. The unstable `box` keyword can be used to both create and destructure -->
+<!-- a `Box`. An example usage would be: -->
+今のところ、安定版において `Box` を作成する唯一の方法は `Box::new` メソッドです。安定版のRustではパターンマッチで `Box` を分解することもできません。不安定版の `box` キーワードは `Box` の作成と分解の両方に使えます。使い方は以下の通りです。
 
 ```rust
 #![feature(box_syntax, box_patterns)]
@@ -25,14 +27,17 @@ fn main() {
 }
 ```
 
-Note that these features are currently hidden behind the `box_syntax` (box
-creation) and `box_patterns` (destructuring and pattern matching) gates
-because the syntax may still change in the future.
+<!-- Note that these features are currently hidden behind the `box_syntax` (box -->
+<!-- creation) and `box_patterns` (destructuring and pattern matching) gates -->
+<!-- because the syntax may still change in the future. -->
+注記: 将来的にこの構文は変わる可能性があるため、現時点でこれらのフィーチャは `box_syntax` (boxの作成)、 `box_patterns` (分解とパターンマッチ)を明示しなければ使えません。
 
-# Returning Pointers
+<!-- # Returning Pointers -->
+# ポインタ返し
 
-In many languages with pointers, you'd return a pointer from a function
-so as to avoid copying a large data structure. For example:
+<!-- In many languages with pointers, you'd return a pointer from a function -->
+<!-- so as to avoid copying a large data structure. For example: -->
+ポインタを持つ多くのプログラミング言語では、巨大なデータ構造のコピーを避けるため、関数からポインタを返してきました。例えば以下のように書くことができます。
 
 ```rust
 struct BigStruct {
@@ -57,10 +62,12 @@ fn main() {
 }
 ```
 
-The idea is that by passing around a box, you're only copying a pointer, rather
-than the hundred `i32`s that make up the `BigStruct`.
+<!-- The idea is that by passing around a box, you're only copying a pointer, rather -->
+<!-- than the hundred `i32`s that make up the `BigStruct`. -->
+考え方としては、boxで渡すことで `BigStruct` を構成する100個の `i32` の代わりにポインタのみのコピーで済む、というものです。
 
-This is an antipattern in Rust. Instead, write this:
+<!-- This is an antipattern in Rust. Instead, write this: -->
+これはRustではアンチパターンです。代わりに以下のように書きます。
 
 ```rust
 #![feature(box_syntax)]
@@ -87,14 +94,17 @@ fn main() {
 }
 ```
 
-This gives you flexibility without sacrificing performance.
+<!-- This gives you flexibility without sacrificing performance. -->
+このように書くことでパフォーマンスを犠牲にすることなく、柔軟性を確保することができます。
 
-You may think that this gives us terrible performance: return a value and then
-immediately box it up ?! Isn't this pattern the worst of both worlds? Rust is
-smarter than that. There is no copy in this code. `main` allocates enough room
-for the `box`, passes a pointer to that memory into `foo` as `x`, and then
-`foo` writes the value straight into the `Box<T>`.
+<!-- You may think that this gives us terrible performance: return a value and then -->
+<!-- immediately box it up ?! Isn't this pattern the worst of both worlds? Rust is -->
+<!-- smarter than that. There is no copy in this code. `main` allocates enough room -->
+<!-- for the `box`, passes a pointer to that memory into `foo` as `x`, and then -->
+<!-- `foo` writes the value straight into the `Box<T>`. -->
+このコードはひどいパフォーマンス低下をもたらすと感じるかもしれません。値を返して即座にboxに入れるなんて?! このパターンは悪いところどりになっているのでは? Rustはもう少し賢いため、このコードでコピーは発生しません。 `main` 内では `box` のために十分なメモリ領域を確保し、そのメモリへのポインタを `foo` へ `x` として渡します。 `foo` はその値を直接 `Box<T>` (訳注: すなわち `y` )の中に書き込みます。
 
-This is important enough that it bears repeating: pointers are not for
-optimizing returning values from your code. Allow the caller to choose how they
-want to use your output.
+<!-- This is important enough that it bears repeating: pointers are not for -->
+<!-- optimizing returning values from your code. Allow the caller to choose how they -->
+<!-- want to use your output. -->
+重要なことなので繰り返しますが、ポインタを戻り値の最適化のために使うべきではありません。呼び出し側が戻り値をどのように使うかを選択できるようにしましょう。

1.6/ja/book/if.md

@@ -1,54 +1,73 @@
 % if
+<!-- % if -->
 
-Rust’s take on `if` is not particularly complex, but it’s much more like the
-`if` you’ll find in a dynamically typed language than in a more traditional
-systems language. So let’s talk about it, to make sure you grasp the nuances.
+<!-- Rust’s take on `if` is not particularly complex, but it’s much more like the -->
+<!-- `if` you’ll find in a dynamically typed language than in a more traditional -->
+<!-- systems language. So let’s talk about it, to make sure you grasp the nuances. -->
+Rustにおける `if` の扱いはさほど複雑ではありませんが、伝統的なシステムプログラミング言語のそれに比べて、
+動的型付け言語でみられる `if` にずっと近いものになっています。そのニュアンスをしっかり理解できるよう、
+さっそく説明していきましょう。
 
-`if` is a specific form of a more general concept, the ‘branch’. The name comes
-from a branch in a tree: a decision point, where depending on a choice,
-multiple paths can be taken.
+<!-- `if` is a specific form of a more general concept, the ‘branch’. The name comes -->
+<!-- from a branch in a tree: a decision point, where depending on a choice, -->
+<!-- multiple paths can be taken. -->
+`if` は一般化されたコンセプト、「分岐(branch)」の特別な形式です。この名前は木の枝(branch)を由来とし:
+取りうる複数のパスから、選択の決定を行うポイントを表します。
 
-In the case of `if`, there is one choice that leads down two paths:
+<!-- In the case of `if`, there is one choice that leads down two paths: -->
+`if` の場合は、続く2つのパスから1つを選択します。
 
 ```rust
 let x = 5;
 
 if x == 5 {
-    println!("x is five!");
+# // println!("x is five!");
+    println!("x は 5 です!");
 }
 ```
 
-If we changed the value of `x` to something else, this line would not print.
-More specifically, if the expression after the `if` evaluates to `true`, then
-the block is executed. If it’s `false`, then it is not.
+<!-- If we changed the value of `x` to something else, this line would not print. -->
+<!-- More specifically, if the expression after the `if` evaluates to `true`, then -->
+<!-- the block is executed. If it’s `false`, then it is not. -->
+仮に `x` を別の値へと変更すると、この行は表示されません。より正確に言うなら、
+`if` のあとにくる式が `true` に評価された場合に、ブロックが実行されます。
+`false` の場合、ブロックは実行されません。
 
-If you want something to happen in the `false` case, use an `else`:
+<!-- If you want something to happen in the `false` case, use an `else`: -->
+`false` の場合にも何かをしたいなら、 `else` を使います:
 
 ```rust
 let x = 5;
 
 if x == 5 {
-    println!("x is five!");
+# // println!("x is five!");
+    println!("x は 5 です!");
 } else {
-    println!("x is not five :(");
+# // println!("x is not five :(");
+    println!("x は 5 ではありません :(");
 }
 ```
 
-If there is more than one case, use an `else if`:
+<!-- If there is more than one case, use an `else if`: -->
+場合分けが複数あるときは、 `else if` を使います:
 
 ```rust
 let x = 5;
 
 if x == 5 {
-    println!("x is five!");
+# // println!("x is five!");
+    println!("x は 5 です!");
 } else if x == 6 {
-    println!("x is six!");
+# // println!("x is six!");
+    println!("x は 6 です!");
 } else {
-    println!("x is not five or six :(");
+# // println!("x is not five or six :(");
+    println!("x は 5 でも 6 でもありません :(");
 }
 ```
 
-This is all pretty standard. However, you can also do this:
+<!-- This is all pretty standard. However, you can also do this: -->
+全くもって普通ですね。しかし、次のような使い方もできるのです:
 
 ```rust
 let x = 5;
@@ -60,14 +79,18 @@ let y = if x == 5 {
 }; // y: i32
 ```
 
-Which we can (and probably should) write like this:
+<!-- Which we can (and probably should) write like this: -->
+次のように書くこともできます（そして、大抵はこう書くべきです）:
 
 ```rust
 let x = 5;
 
 let y = if x == 5 { 10 } else { 15 }; // y: i32
 ```
 
-This works because `if` is an expression. The value of the expression is the
-value of the last expression in whichever branch was chosen. An `if` without an
-`else` always results in `()` as the value.
+<!-- This works because `if` is an expression. The value of the expression is the -->
+<!-- value of the last expression in whichever branch was chosen. An `if` without an -->
+<!-- `else` always results in `()` as the value. -->
+これが出来るのは `if` が式であるためです。その式の値は、選択された分岐中の最後の式の値となります。
+`else` のない `if` では、その値は常に `()` となります。
+

1.6/ja/book/ownership.md

@@ -6,7 +6,7 @@
 <!-- become quite acquainted. Ownership is how Rust achieves its largest goal, -->
 <!-- memory safety. There are a few distinct concepts, each with its own -->
 <!-- chapter: -->
-このガイドはRustの所有権システムの3つの解説の1つです。
+このガイドはRustの所有権システムの3つの解説の1つ目です。
 これはRustの最も独特で注目されている機能です。そして、Rust開発者はそれについて高度に精通しておくべきです。
 所有権こそはRustがその最大の目標、メモリ安全性を得るための方法です。
 そこにはいくつかの別個の概念があり、各概念が独自の章を持ちます。