HashMap::contains_key() / remove() / entry()

use std::collections::HashMap;

// キーが存在するか確認します（bool を返します）。
let exists = map.contains_key("apple");

// キーとその値を削除します（Option<V> を返します）。
let removed = map.remove("apple");  // Some(値) または None

// entry API: キーが存在しなければ挿入します。
map.entry("key".to_string()).or_insert(0);

// entry API: 存在する値を更新します。
let count = map.entry("key".to_string()).or_insert(0);
*count += 1;  // 値をインクリメントします。

use std::collections::HashMap;

fn main() {
    let mut map: HashMap<String, i32> = HashMap::new();
    map.insert("apple".to_string(), 3);
    map.insert("banana".to_string(), 5);
    map.insert("cherry".to_string(), 2);

    // contains_key() でキーの存在を確認します。
    println!("apple あり?: {}", map.contains_key("apple"));   // true
    println!("grape あり?: {}", map.contains_key("grape"));   // false

    // remove() でエントリを削除します。
    let removed = map.remove("banana");
    println!("削除した値: {:?}", removed);  // Some(5)
    println!("削除後の長さ: {}", map.len());  // 2

    let none = map.remove("grape");  // 存在しないキー
    println!("存在しないキーを削除: {:?}", none);  // None

    // --- entry API ---
    // 単語の出現回数をカウントします（典型的なentry活用例）。
    let text = "hello world hello rust hello world";
    let mut counts: HashMap<String, i32> = HashMap::new();

    for word in text.split_whitespace() {
        let count = counts.entry(word.to_string()).or_insert(0);
        *count += 1;  // 参照を通じて値をインクリメントします。
    }
    println!("単語カウント: {:?}", counts);

    // or_default() で Default trait のデフォルト値を使います。
    let mut vmap: HashMap<String, Vec<i32>> = HashMap::new();
    vmap.entry("evens".to_string()).or_default().push(2);
    vmap.entry("evens".to_string()).or_default().push(4);
    vmap.entry("odds".to_string()).or_default().push(1);
    println!("グループ: {:?}", vmap);

    // and_modify() で既存の値だけを変更します。
    let mut scores: HashMap<String, i32> = HashMap::new();
    scores.insert("Alice".to_string(), 90);
    scores.entry("Alice".to_string()).and_modify(|s| *s += 10);
    scores.entry("Bob".to_string()).and_modify(|s| *s += 10).or_insert(0);
    println!("scores: {:?}", scores);  // Aliceは100、Bobは0

    // retain() で条件を満たすエントリのみ残します。
    let mut m: HashMap<&str, i32> = [("a", 1), ("b", 2), ("c", 3), ("d", 4)]
        .iter().cloned().collect();
    m.retain(|_, v| *v >= 3);  // 値が3以上のエントリだけ残します。
    println!("retain（value >= 3）: {:?}", m);
}

entry APIはHashMapの最も慣用的な使い方の一つです。「キーが存在しなければ挿入し、存在すれば更新する」という処理を安全かつ効率的に書けます。単語カウントのような集計処理でよく使われます。

『or_insert()』は値の可変参照（&mut V）を返します。この参照を通じて値を変更できるため、インクリメントや配列への追加が可能です。

HashMapの生成・基本操作は『HashMap::new() / insert() / get()』を、イテレーションは『HashMap::keys() / values() / iter()』を参照してください。