Publish Comprehensive Rust 🦀

src/pattern-matching/destructuring-arrays.md

@@ -0,0 +1,7 @@
+# Destructuring Arrays
+
+You can destructure arrays, tuples, and slices by matching on their elements:
+
+```rust,editable
+{{#include ../../third_party/rust-by-example/destructuring-arrays.rs}}
+```

src/pattern-matching/destructuring-enums.md

@@ -0,0 +1,31 @@
+# Destructuring Enums
+
+Patterns can also be used to bind variables to parts of your values. This is how
+you inspect the structure of your types. Let us start with a simple `enum` type:
+
+```rust,editable
+enum Result {
+    Ok(i32),
+    Err(String),
+}
+
+fn divide_in_two(n: i32) -> Result {
+    if n % 2 == 0 {
+        Result::Ok(n / 2)
+    } else {
+        Result::Err(format!("cannot divide {} into two equal parts", n))
+    }
+}
+
+fn main() {
+    let n = 100;
+    match divide_in_two(n) {
+        Result::Ok(half) => println!("{n} divided in two is {half}"),
+        Result::Err(msg) => println!("sorry, an error happened: {msg}"),
+    }
+}
+```
+
+Here we have used the arms to _destructure_ the `Result` value. In the first
+arm, `half` is bound to the value inside the `Ok` variant. In the second arm,
+`msg` is bound to the error message.

src/pattern-matching/destructuring-structs.md

@@ -0,0 +1,7 @@
+# Destructuring Structs
+
+You can also destructure `structs`:
+
+```rust,editable
+{{#include ../../third_party/rust-by-example/destructuring-structs.rs}}
+```

src/pattern-matching/match-guards.md

@@ -0,0 +1,8 @@
+# Match Guards
+
+When matching, you can add a _guard_ to a pattern. This is an arbitrary Boolean
+expression which will be executed if the pattern matches:
+
+```rust,editable
+{{#include ../../third_party/rust-by-example/match-guards.rs}}
+```