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よくある間違い
この例では元のキーの変化を調べます。追加されたキーを見つけるには、新しいマップのキーも調べます。