【News】Mapのループ処理:全エントリを操作するentrySet・keySet・values

こんにちは、バナナドリームです。
前回はMapから安全に値を取り出す方法を解説しました。
今回はMapの中身を「一括で処理する」ループ処理がテーマです。Mapには entrySet()・keySet()・values() という3つのループ用メソッドがあり、それぞれ用途が異なります。順に見ていきましょう。

なぜListと同じようにループできないのか

Listはインデックスで順番が決まっているため、foreachでそのまま回せました。
一方、Mapはキーと値のペアで管理されており、インデックスがありません。そのため、Mapをループするには「何を取り出してループするか」を最初に選ぶ必要があります。

その選択肢が entrySet()・keySet()・values() の3つです。

entrySet():キーと値を両方使いたいとき

entrySet() はMapの全エントリを「キーと値のペア」として取り出します。キーも値も両方使いたい場面では、これが最も基本的な選択です。

Map<String, Integer> scores = new HashMap<>();
scores.put("Taro", 85);
scores.put("Hanako", 92);
scores.put("Jiro", 78);

for (Map.Entry<String, Integer> entry : scores.entrySet()) {
System.out.println(entry.getKey() + " の点数:" + entry.getValue());
} 
// 出力例:
// Taro の点数:85
// Hanako の点数:92
// Jiro の点数:78
// ※HashMapでは表示順は保証されません 

entry.getKey() でキー、entry.getValue() で値を取り出します。「全ユーザーの情報を一覧表示する」「全エントリに対して何らかの加工をする」といった場面で広く使えます。

keySet():キーだけを使いたいとき

keySet() はMapのキーだけをSetとして取り出します。キーの一覧が必要な場面や、キーを使って別の処理をしたい場合に使います。

Map<String, Integer> scores = new HashMap<>();
scores.put("Taro", 85);
scores.put("Hanako", 92);
scores.put("Jiro", 78);

for (String key : scores.keySet()) {
    System.out.println(key);
}
// 出力例:
// Taro
// Hanako
// Jiro
// ※HashMapでは表示順は保証されません 

「登録済みのIDをすべて出力したい」「キーの一覧を別のListに集めたい」といった場面で役立ちます。

なお、keySet() でキーを取り出したあと get() で値を引くこともできますが、entrySet() のほうが1回の取り出しでキーと値の両方を得られるため、両方使う場面では entrySet() が推奨されます。

// こう書くこともできるが…
for (String key : scores.keySet()) {
    System.out.println(key + ":" + scores.get(key)); // get()を都度呼ぶのは非効率
}

// キーと値の両方が必要ならentrySet()のほうがよい

values():値だけを使いたいとき

values() はMapの値だけをCollectionとして取り出します。キーは不要で、値の集計や検索だけしたい場面に向いています。

Map<String, Integer> scores = new HashMap<>();

scores.put("Taro", 85);

scores.put("Hanako", 92);

scores.put("Jiro", 78);

int total = 0;

for (int score : scores.values()) {

total += score;

}

System.out.println("合計点:" + total); // → 合計点:255

「全員の点数の合計を出したい」「値の中に特定の数値が含まれるか確認したい」といった処理では、values() を使うことでキーを意識せずにシンプルに書けます。

3つのメソッドの使い分け

キーと値の両方を使いたい場合は entrySet() を使います。
キーだけを使いたい場合は keySet() を使います。
値だけを使いたい場合は values() を使います。

迷ったときは「このループの中でキーを使うか?値を使うか?」と自問するだけで自然に決まります。

ループ中に値を加工する

entrySet() のループ中で setValue() を使うと、値をその場で書き換えることもできます。

Map<String, Integer> prices = new HashMap<>();
prices.put("Apple", 100);
prices.put("Banana", 80);
prices.put("Orange", 120);

for (Map.Entry<String, Integer> entry : prices.entrySet()) {
    entry.setValue((int)(entry.getValue() * 1.1)); // 10%値上げ
}
System.out.println(prices);
// 出力例:{Apple=110, Banana=88, Orange=132}
// ※HashMapでは表示順は保証されません 

元のMapを直接書き換えたい場合に有効です。加工前のデータも残しておきたい場合は、新しいMapに put() していく方法を選びましょう。

Stream APIを使った書き方

ループ処理もStreamで書くことができます。例えば entrySet() との組み合わせはこのようになります。

scores.entrySet().stream()
    .forEach(entry ->
        System.out.println(entry.getKey() + ":" + entry.getValue())
    );

また、値を条件で絞り込みながら処理したい場合は filter() と組み合わせると便利です。

scores.entrySet().stream()
    .filter(entry -> entry.getValue() >= 80)
    .forEach(entry ->
        System.out.println(entry.getKey() + " は合格")
    );

// 出力例:
// Taro は合格
// Hanako は合格
// ※HashMapでは表示順は保証されません

ループとStreamのどちらが適切かは処理の複雑さによりますが、「絞り込みながらループしたい」場面ではStreamの組み合わせが読みやすくなることが多いです。

まとめ

・Mapのループには entrySet()・keySet()・values() の3つを使う
・キーと値の両方が必要なら entrySet()、キーだけなら keySet()、値だけなら values()
・keySet() でループしながら get() を都度呼ぶより、entrySet() のほうが効率的
・ループ中に値を書き換えたい場合は setValue() が使える
・絞り込みを伴う処理には entrySet().stream() と filter() の組み合わせが有効

次回:「ListとMapを組み合わせる:複数データを構造的に管理する方法」

実務では「1つのキーに対して複数の値を持たせたい」という場面がよく出てきます。
次回は Map<String, List<String>> のような入れ子構造の作り方と、その操作方法を解説します。 

有限会社バナナドリーム

千葉県浦安市を拠点に、Javaを中心としたシステム開発からITコンサルタント、Webサイト制作まで幅広く手がけるシステム開発会社です。
開発・実装からアフターフォローまで一貫して対応し、お客様の課題に寄り添ったきめ細やかなサービスを提供しています。

「やさしさがつなぐ、人と未来と技術。」を掲げ、技術力だけでなく人と人とのつながりを大切にした経営を実践。
社員一人ひとりの個性を尊重し、30名規模を上限とした少数精鋭体制のもと、社員・顧客・地域社会のすべてと良好な関係を築くことを理念としています。

「Realize Dream ~夢は実現する為にある~」という言葉のもと、関わるすべての人の夢の実現をサポートし続けます。

お問い合わせはこちら