中級

HashMapを存在しないキーで [] 添字アクセスすると no entry found for key パニックになる

HashMapに[]で添字アクセスした際、そのキーが存在しないとパニックします。存在するかどうか分からないキーを扱う場合は、getメソッドを使いOptionとして受け取る必要があります。

エラーメッセージの読み方

thread 'main' panicked at main.rs:5:24:

main.rs

ファイル名

5

行番号 — 実際にクラッシュした行

24

列番号

panicked

パニック — 実行時に回復不能な状態になったことを示します。tryやResultで捕まえない限り、そのままプロセスが終了します

no entry found for key

詳細メッセージ — どの値が問題だったか

このエラーが出る典型パターン

 1  use std::collections::HashMap;
 2  fn main() {
 3      let mut ages: HashMap<&str, i32> = HashMap::new();
 4      ages.insert("taro", 20);
 5      println!("{}", ages["hanako"]);
                                ^
 6  }

 1  use std::collections::HashMap;
 2  fn main() {
 3      let mut prices: HashMap<&str, i32> = HashMap::new();
 4      prices.insert("apple", 100);
 5      println!("{}", prices["banana"]);
                                  ^
 6  }

 1  use std::collections::HashMap;
 2  fn main() {
 3      let mut stock: HashMap<&str, i32> = HashMap::new();
 4      stock.insert("pen", 5);
 5      println!("{}", stock["pencil"]);
                                 ^
 6  }

 1  use std::collections::HashMap;
 2  fn main() {
 3      let mut scores: HashMap<&str, i32> = HashMap::new();
 4      scores.insert("math", 90);
 5      println!("{}", scores["science"]);
                                  ^
 6  }

 1  use std::collections::HashMap;
 2  fn main() {
 3      let mut config: HashMap<&str, i32> = HashMap::new();
 4      config.insert("timeout", 30);
 5      println!("{}", config["retries"]);
                                  ^
 6  }

よくある誤解

「存在しないキーで参照すれば、配列の範囲外アクセスのようにnilや空の値が返るはず」という思い込みは誤りです。HashMapの[]演算子は見つからない場合にエラーを返さず、その場でパニックします。

実務での勘所

この挙動は特別な仕組みではなく、HashMapの[]演算子(Indexトレイトの実装)が、内部でget(key).expect("no entry found for key")のような処理を行っているだけです。表示されるパニックメッセージ自体が、標準ライブラリの内部で呼ばれているexpectの引数そのものです。つまりこれは、OptionやResultのunwrap・expectで見てきたのと同じ「グレースフルなデフォルトを用意しない」という設計を、[]という別の構文に対しても一貫して適用した結果です。

演習をはじめる

関連するエラー

• called `Option::unwrap()` on a `None` value パニックの原因と直し方Option<T>型の値がNoneのときにunwrap()を呼び出すと、パニックが発生してプログラムが異常終了します。
• index out of bounds パニックの原因と直し方存在しない添字でVecや配列にアクセスすると、コンパイルは通りますが実行時にパニックしてプログラムが異常終了します。