中級

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を存在しないキーで [] 添字アクセスすると no entry found for key パニックになるは中級でつまずきやすい項目です。上の5パターンを実際に手で直すと、エラーメッセージのどこを読めばよいかが掴めます。

演習をはじめる

関連するエラー

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