DartのLinkedHashMapにキーが存在するか確認する

この記事は 2026 年 10 月 8 日に投稿しました。

1. はじめに

こんにちは、iOS のエディタアプリPWEditorとその後継PWEditorNextの開発者の二俣です。
2018年5月から毎日技術ブログを更新しています。

今回はDartのLinkedHashMapのcontainsKeyメソッドについてです。

containsKeyメソッドを使うと、指定したキーがLinkedHashMapに含まれているかどうかを確認できます。戻り値はbool型で、キーが存在すればtrue、存在しなければfalseです。

目次へ

2. DartのLinkedHashMapにキーが存在するか確認する

DartのLinkedHashMapは、キーと値の組をキーの挿入順に反復できるMapの実装です。containsKeyメソッドはMapから継承されており、指定したキーがMapに登録されているかを調べます。

メソッドの型は以下のとおりです。

bool containsKey(Object? key)

引数には存在を調べるキーを指定します。戻り値は、キーが登録されている場合はtrue、登録されていない場合はfalseです。引数の型はObject?なので、Mapのキーの型と異なる値を渡しても呼び出せます。その場合、通常は一致するキーがないためfalseになります。

目次へ

3. containsKeyメソッドの基本的な使い方

containsKeyを使って、LinkedHashMapに特定のキーがあるか確認できます。

import 'dart:collection';

void main() {
  final LinkedHashMap<String, int> scores = LinkedHashMap<String, int>()
    ..['太郎'] = 80
    ..['花子'] = 95;

  print(scores.containsKey('太郎')); // true
  print(scores.containsKey('次郎')); // false
}

太郎はキーとして登録されているためtrue、次郎は登録されていないためfalseになります。値を取得する前にキーの存在を確認したい場合などに利用できます。

final String name = '花子';

if (scores.containsKey(name)) {
  print(scores[name]); // 95
}

目次へ

4. 値がnullの場合にキーの有無を確認する

Mapの値の型がnullableである場合、キーが存在していて値がnullのことがあります。値を取得した結果だけでは、キーが存在しないのか、値がnullなのかを区別できません。containsKeyを使えば、キーの有無を確認できます。

import 'dart:collection';

void main() {
  final LinkedHashMap<String, int?> values = LinkedHashMap<String, int?>()
    ..['設定済み'] = 10
    ..['未設定'] = null;

  print(values['未設定']); // null
  print(values.containsKey('未設定')); // true
  print(values.containsKey('存在しない')); // false
}