Update original

Author: dalance

.examples-en

@@ -100,12 +100,14 @@
     - [match](flow_control/match.md)
         - [Destructuring](flow_control/match/destructuring.md)
             - [tuples](flow_control/match/destructuring/destructure_tuple.md)
+            - [arrays/slices](flow_control/match/destructuring/destructure_slice.md)
             - [enums](flow_control/match/destructuring/destructure_enum.md)
             - [pointers/ref](flow_control/match/destructuring/destructure_pointers.md)
             - [structs](flow_control/match/destructuring/destructure_structures.md)
         - [Guards](flow_control/match/guard.md)
         - [Binding](flow_control/match/binding.md)
     - [if let](flow_control/if_let.md)
+    - [let-else](flow_control/let_else.md)
     - [while let](flow_control/while_let.md)
 -->
 - [条件分岐](flow_control.md)
@@ -315,10 +317,12 @@
 <!--
 - [Error handling](error.md)
     - [`panic`](error/panic.md)
+    - [`abort` & `unwind`](error/abort_unwind.md)
     - [`Option` & `unwrap`](error/option_unwrap.md)
         - [Unpacking options with `?`](error/option_unwrap/question_mark.md)
         - [Combinators: `map`](error/option_unwrap/map.md)
         - [Combinators: `and_then`](error/option_unwrap/and_then.md)
+        - [Defaults: `or`, `or_else`, `get_or_insert`, 'get_or_insert_with`](error/option_unwrap/defaults.md)
     - [`Result`](error/result.md)
         - [`map` for `Result`](error/result/result_map.md)
         - [aliases for `Result`](error/result/result_alias.md)
@@ -423,6 +427,7 @@
 
 <!--
 - [Unsafe Operations](unsafe.md)
+    - [Inline assembly](unsafe/asm.md)
 -->
 - [安全でない操作](unsafe.md)
 
@@ -432,7 +437,7 @@
 <!--
 - [Meta](meta.md)
     - [Documentation](meta/doc.md)
-    - [Playpen](meta/playpen.md)
+    - [Playground](meta/playground.md)
 -->
 - [周辺情報](meta.md)
     - [ドキュメンテーション](meta/doc.md)

src/SUMMARY.md

@@ -19,6 +19,7 @@ can be used to/for:
 * link to a foreign library
 * mark functions as unit tests
 * mark functions that will be part of a benchmark
+* [attribute like macros][macros]
 -->
 * [コンパイル時の条件分岐][cfg]
 * [クレート名、バージョン、種類（バイナリか、ライブラリか）の設定][crate]
@@ -57,3 +58,4 @@ Attributes can have multiple values and can be separated over multiple lines, to
 [cfg]: attribute/cfg.md
 [crate]: attribute/crate.md
 [lint]: https://en.wikipedia.org/wiki/Lint_%28software%29
+[macros]: https://doc.rust-lang.org/book/ch19-06-macros.html#attribute-like-macros

src/attribute.md

@@ -20,6 +20,8 @@ utilize identical argument syntax.
 前者は条件付きコンパイルを行いますが、後者は`true`または`false`リテラルに評価され実行時にチェックすることが可能です。
 いずれの場合も適切なシンタックスで記述する必要があります。
 
+`cfg!`, unlike `#[cfg]`, does not remove any code and only evaluates to true or false. For example, all blocks in an if/else expression need to be valid when `cfg!` is used for the condition, regardless of what `cfg!` is evaluating.
+
 ```rust,editable
 // This function only gets compiled if the target OS is linux
 // この関数はターゲットOSがLinuxの時のみコンパイルされる。

src/attribute/cfg.md

@@ -38,11 +38,11 @@ foo
 ```
 
 <!--
-To tell `cargo` to compile or run this binary as opposed to the default or other
-binaries, we just pass `cargo` the `--bin my_other_bin` flag, where `my_other_bin`
-is the name of the binary we want to work with.
+To tell `cargo` to only compile or run this binary, we just pass `cargo` the
+`--bin my_other_bin` flag, where `my_other_bin` is the name of the binary we
+want to work with.
 -->
-デフォルトバイナリや他のバイナリではなく、このバイナリをコンパイルや実行するように`cargo`に伝えるには、`cargo`に`--bin my_other_bin`フラグを渡します。ここでは`my_other_bin`が対象のバイナリの名前です。
+このバイナリだけをコンパイルや実行するように`cargo`に伝えるには、`cargo`に`--bin my_other_bin`フラグを渡します。ここでは`my_other_bin`が対象のバイナリの名前です。
 
 <!--
 In addition to extra binaries, `cargo` supports [more features] such as

src/cargo/conventions.md

@@ -21,9 +21,9 @@ Rustのプロジェクトを新しく作るには下記のようにします。
 # バイナリ
 cargo new foo
 
-# OR A library
-# またはライブラリ
-cargo new --lib foo
+# A library
+# ライブラリ
+cargo new --lib bar
 ```
 
 <!--
@@ -38,18 +38,23 @@ After the above commands, you should see a file hierarchy like this:
 上のコマンドを実行すると、次のようなファイル階層ができます。
 
 ```txt
-foo
-├── Cargo.toml
-└── src
-    └── main.rs
+.
+├── bar
+│   ├── Cargo.toml
+│   └── src
+│       └── lib.rs
+└── foo
+    ├── Cargo.toml
+    └── src
+        └── main.rs
 ```
 
 <!--
-The `main.rs` is the root source file for your new project -- nothing new there.
-The `Cargo.toml` is the config file for `cargo` for this project (`foo`). If you
+The `main.rs` is the root source file for your new `foo` project -- nothing new there.
+The `Cargo.toml` is the config file for `cargo` for this project. If you
 look inside it, you should see something like this:
 -->
-`main.rs`がこの新規プロジェクトのルートのソースファイルです。なにも新しいことはありませんね。`Cargo.toml`はこのプロジェクト（`foo`）の`cargo`の設定ファイルです。中を見てみるとこのようになっています。
+`main.rs`がこの新規プロジェクト `foo` のルートのソースファイルです。なにも新しいことはありませんね。`Cargo.toml`はこのプロジェクトの`cargo`の設定ファイルです。中を見てみるとこのようになっています。
 
 ```toml
 [package]

src/cargo/deps.md

@@ -87,7 +87,7 @@ impl From<i32> for Number {
 
 fn main() {
     let int = 5;
-    // Try removing the type declaration
+    // Try removing the type annotation
     let num: Number = int.into();
     println!("My number is {:?}", num);
 }

src/conversion/from_into.md

@@ -20,7 +20,7 @@ fn main() {
 ```txt
 # Where library.rlib is the path to the compiled library, assumed that it's
 # in the same directory here:
-$ rustc executable.rs --extern rary=library.rlib --edition=2018 && ./executable 
+$ rustc executable.rs --extern rary=library.rlib && ./executable 
 called rary's `public_function()`
 called rary's `indirect_access()`, that
 > called rary's `private_function()`

src/crates/using_lib.md

@@ -5,7 +5,7 @@
 
 <!--
 The `enum` keyword allows the creation of a type which may be one of a few
-different variants. Any variant which is valid as a `struct` is also valid as
+different variants. Any variant which is valid as a `struct` is also valid in
 an `enum`.
 -->
 列挙型(`enum`)はいくつかの異なる要素型の中から1つを選ぶような場合に使用します。構造体(`struct`)の定義を満たすものならば何でも`enum` の要素型として使用できます。
@@ -21,7 +21,7 @@ an `enum`.
 // `KeyPress(char) != Paste(String)` である。
 // 要素型は互いに異なり、互いに非依存である。
 enum WebEvent {
-    // An `enum` may either be `unit-like`,
+    // An `enum` variant may either be `unit-like`,
     // `enum`要素型はユニット風でもよい
     PageLoad,
     PageUnload,
@@ -41,7 +41,7 @@ fn inspect(event: WebEvent) {
     match event {
         WebEvent::PageLoad => println!("page loaded"),
         WebEvent::PageUnload => println!("page unloaded"),
-        // Destructure `c` from inside the `enum`.
+        // Destructure `c` from inside the `enum` variant.
         WebEvent::KeyPress(c) => println!("pressed '{}'.", c),
         WebEvent::Paste(s) => println!("pasted \"{}\".", s),
         // Destructure `Click` into `x` and `y`.

src/custom_types/enum.md

@@ -19,6 +19,9 @@ There are three types of structures ("structs") that can be created using the
 * ユニット。これはフィールドを持たず、ジェネリック型を扱う際に有効です。
 
 ```rust,editable
+// An attribute to hide warnings for unused code.
+#![allow(dead_code)]
+
 #[derive(Debug)]
 struct Person {
     name: String,

src/custom_types/structs.md

@@ -0,0 +1,51 @@
+# `abort` and `unwind`
+
+The previous section illustrates the error handling mechanism `panic`.  Different code paths can be conditionally compiled based on the panic setting. The current values available are `unwind` and `abort`. 
+
+
+Building on the prior lemonade example, we explicitly use the panic strategy to exercise different lines of code.  
+
+```rust,editable,mdbook-runnable
+
+fn drink(beverage: &str) {
+   // You shouldn't drink too much sugary beverages.
+    if beverage == "lemonade" {
+        if cfg!(panic="abort"){ println!("This is not your party. Run!!!!");}
+        else{ println!("Spit it out!!!!");}
+    }
+    else{ println!("Some refreshing {} is all I need.", beverage); }
+}
+
+fn main() {
+    drink("water");
+    drink("lemonade");
+}
+```
+
+Here is another example focusing on rewriting `drink()` and explicitly use the `unwind` keyword.
+
+```rust,editable
+
+#[cfg(panic = "unwind")]
+fn ah(){ println!("Spit it out!!!!");}
+
+#[cfg(not(panic="unwind"))]
+fn ah(){ println!("This is not your party. Run!!!!");}
+
+fn drink(beverage: &str){
+    if beverage == "lemonade"{ ah();}
+    else{println!("Some refreshing {} is all I need.", beverage);}
+}
+
+fn main() {
+    drink("water");
+    drink("lemonade");
+}
+```
+
+The panic strategy can be set from the command line by using `abort` or `unwind`.
+
+```console
+rustc  lemonade.rs -C panic=abort
+```
+

src/error/abort_unwind.md

@@ -45,17 +45,36 @@ fn main() {
 }
 ```
 
+## Collect the failed items with `map_err()` and `filter_map()`
+
+`map_err` calls a function with the error, so by adding that to the previous
+`filter_map` solution we can save them off to the side while iterating.
+
+```rust,editable
+fn main() {
+    let strings = vec!["42", "tofu", "93", "999", "18"];
+    let mut errors = vec![];
+    let numbers: Vec<_> = strings
+        .into_iter()
+        .map(|s| s.parse::<u8>())
+        .filter_map(|r| r.map_err(|e| errors.push(e)).ok())
+        .collect();
+    println!("Numbers: {:?}", numbers);
+    println!("Errors: {:?}", errors);
+}
+```
+
 <!--
 ## Fail the entire operation with `collect()`
 -->
 ## `collect()`で処理全体を失敗させる
 
 <!--
-`Result` implements `FromIter` so that a vector of results (`Vec<Result<T, E>>`)
+`Result` implements `FromIterator` so that a vector of results (`Vec<Result<T, E>>`)
 can be turned into a result with a vector (`Result<Vec<T>, E>`). Once an
 `Result::Err` is found, the iteration will terminate.
 -->
-`Result`は、それらのベクトル(`Vec<Result<T, E>>`)からベクトルのそれ(`Result<Vec<T>, E>`)へと変換できるようにするため、`FromIter`を実装します。`Result::Err`が見つかり次第、イテレーションは終了します。
+`Result`は、それらのベクトル(`Vec<Result<T, E>>`)からベクトルのそれ(`Result<Vec<T>, E>`)へと変換できるようにするため、`FromIterator`を実装します。`Result::Err`が見つかり次第、イテレーションは終了します。
 
 ```rust,editable
 fn main() {

src/error/iter_result.md

@@ -10,7 +10,7 @@ Boxする方法の代替として、エラーを自前のエラー型として
 
 ```rust,editable
 use std::error;
-use std::error::Error as _;
+use std::error::Error;
 use std::num::ParseIntError;
 use std::fmt;