🧠 函式（Function）：定義、參數、呼叫一次搞懂

在 Rust 中，函式（function） 是用來封裝一組可重複執行的指令步驟。
你可以將重複的邏輯寫成函式，在需要的時候「呼叫」它，讓程式碼更乾淨、可讀性更高！

📘 範例程式碼

fn main() {
    open_store("NewYork");
    bake_pizze(12, "pepperoni");
    swim_in_profit();
    open_store("Brooklyn");
}

fn open_store(neighborhood: &str) {
    println!("Opening my pizza store in {}.", neighborhood);
}

fn bake_pizze(number: i32, topping: &str) {
    println!("Baking {} {} pizza.", number, topping);
}

fn swim_in_profit() {
    println!("So much $$$, so little time.");
}

🔍 程式碼說明

📦 函式定義 vs 呼叫重點比較

✅ 小結

• fn 是函式的定義關鍵字。
• 函式可以接受參數（parameter），讓它執行時更具彈性。
• 呼叫函式時，要傳入對應的引數（argument）。
• 主函式 main() 是 Rust 程式的入口，其他函式可以在裡面依序執行

🧠 函式回傳值（Return Value）

在 Rust 中，函式（function）不只可以執行一連串操作，還可以「回傳一個值」給呼叫者。
這個值被稱為：回傳值（return value）。

📘 範例程式碼

fn main() {
    let result = square(5);
    println!("The square of 5 is {}.", result);

    let result = square(12);
    println!("The square of 12 is {}.", result);
}

fn square(number: i32) -> i32 {
    return number * number;
}

🧩 程式碼說明

另外如果把square函式寫成：

fn square(number: i32) -> i32 {
    number * number
}

在 Rust 中，函式的最後一行如果是「沒有分號的表達式」，它會被自動作為回傳值。這就叫做：
✅ Implicit Return（隱式回傳）
不用寫 return，Rust 會自動把最後一行「沒加分號的表達式」當作回傳值。
✅ Explicit Return（顯式回傳）
就是使用 return 關鍵字明確指定回傳值，後面要加分號 ;

🧠 Rust 的 Unit 類型：() 是什麼？有什麼用？

在 Rust 中，有一種非常特別的型別叫做 Unit 型別，寫作 ()，而()是一個合法的型別（不像 JavaScript 的 undefined），它表示：無回傳值、無內容，但仍代表「這個運算已完成」。

當然它不是空的陣列，也不是空的字串，而是：

✅ 一個 沒有值的元組（tuple without values），也被稱為「單元值」。

📘 程式範例

fn main() {
    let _result = mystery(); // _result 的型別是 ()
}

fn mystery() {
    // 沒有回傳值，也沒用 return，Rust 自動回傳 ()
}

即使 mystery() 函式裡什麼都沒做，它還是會自動回傳 ()，這就是 Rust 的 Unit 型別。

🧠 用途與特性整理

✅ 補充：什麼時候會用到 Unit？

1.函式沒有回傳值時：

fn log_info(message: &str) {
    println!("{}", message);
    // 自動回傳 ()
}

2.用作成功但沒有值的訊號：

fn try_something() -> Result<(), String> {
    if true {
        Ok(())
    } else {
        Err("Something went wrong.".to_string())
    }
}

3.作為測試副作用的函式：

fn do_nothing() {}

🧱 Block（區塊）教學：不只是包起來那麼簡單！

在 Rust 中，區塊（block） 是使用大括號 {} 括起來的一段程式碼。
它不僅用來包裹語句（statement），更是一個「表達式（expression）」，可以回傳值！

📘 範例程式碼

fn main() {
    let multiplier = 3;

    let calculation = {
        let value = 5 + 4;
        value * multiplier
    };

    println!("{}", calculation); // ➜ 27
}

🧩 程式解析

✅ 最後印出 calculation，結果是：9 × 3 = 27

🧠 Block 的用途與特性

✅ Block 回傳值的規則