Rust リファレンス

実行できる例で、Result を使うパース、キーと値の分割、順序付きマップの比較を学びます。

サンプルの実行方法

各例を main.rs として保存します。macOS または Linux で rustc main.rs を実行し、続いて ./main を実行します。Rust の標準ライブラリを使います。

Result を使って数値をパースする

u16 への変換では書式と表現できる値の範囲が検証されます。Ok と Err を分けて処理すると、無効な入力が既定値に置き換わるのを防げます。

rust
fn main() {
    for input in ["8080", "65536", "oops"] {
        match input.parse::<u16>() {
            Ok(port) => println!("port: {port}"),
            Err(_) => println!("invalid: {input}"),
        }
    }
}

出力例

port: 8080
invalid: 65536
invalid: oops

よくある間違い

u16 への変換だけでは、ポート 0 を拒否するなどのアプリケーションの規則は適用されません。変換後に確認します。

公式ドキュメント

最初の等号でキーと値を分ける

split_once は最初の区切り文字の両側を借用スライスとして返します。それ以降の等号は値の一部として残ります。

rust
fn main() {
    if let Some((key, value)) = "MODE=fast=local".split_once('=') {
        println!("{key}: {value}");
    }
}

出力例

MODE: fast=local

よくある間違い

この例は単純なキーと値の行を扱います。引用符、エスケープ、変数展開には、その形式に対応するパーサーが必要です。

公式ドキュメント

キー順に値を比較する

BTreeMap はキー順に反復します。変更レポートの順序をそろえるときに使い、存在しないキーは個別に処理します。

rust
use std::collections::BTreeMap;

fn main() {
    let before = BTreeMap::from([("timeout", 10), ("port", 80)]);
    let after = BTreeMap::from([("port", 8080), ("timeout", 0)]);
    for (key, old) in &before {
        if let Some(current) = after.get(key) {
            if current != old {
                println!("{key}: {old} -> {current}");
            }
        }
    }
}

出力例

port: 80 -> 8080
timeout: 10 -> 0

よくある間違い

この例では元のキーの変化を調べます。追加されたキーを見つけるには、新しいマップのキーも調べます。

公式ドキュメント

関連ツール