HOWTO · Java

Java で 2つのリストを結合する方法

Javaで2つのリストを結合するには、コピーまたはストリーム処理で別の結果リストを作る方法と、addAll()で先頭のリストに直接追加して変更する方法があります。

このページの内容

Javaで2つのリストを結合するには、別の結果リストを作る方法と、変更可能な最初のリストに2つ目のリストを追加する方法があります。ArrayListにコピーしてからaddAll()を呼び出す方法や、Stream.concat()の結果をリストに収集する方法では、元のリストの構造は変わりません。最初のリストに直接addAll()を呼び出すと、そのリストが変更されます。どの方法でも要素の出現順が保たれ、重複も残ります。

コピーしてaddAll()を使い、新しいリストに結合する

ArrayListのコレクションコンストラクタは、最初のリストの要素を新しいリストにコピーします。その結果にaddAll()を呼び出すと、2つ目のリストの要素が末尾に追加されます。元のリストの構造を変えず、結合結果を変更可能にしたい場合に適した方法です。ただし、コピーは浅いコピーです。リストに変更可能なオブジェクトが含まれている場合、新しいリストにも同じオブジェクトへの参照が格納されます。

次の例を実行してください。コードと出力はバイト単位で保持されるため、出力に表示される色名は英語のままです。

import java.util.ArrayList;
import java.util.Arrays;
import java.util.List;

public class Main {
    public static void main(String[] args) {
        List<String> first = new ArrayList<>(Arrays.asList("red", "green"));
        List<String> second = Arrays.asList("blue", "gold");

        List<String> combined = new ArrayList<>(first);
        combined.addAll(second);
        System.out.println(combined);
    }
}
[red, green, blue, gold]

結果を格納する変数を先に宣言し、new ArrayList<>(first)を代入してからcombined.addAll(second)を呼び出すこともできます。これも同じコピー後に追加する操作なので、結果と元のリストへの影響は同じです。

Stream.concat()でリストを結合する

Stream.concat(first.stream(), second.stream())は、最初のリストの要素に続けて2つ目のリストの要素を処理するストリームを作成します。結果を保持するには、ストリームをリストに収集します。このAPIは、返されるリストが変更可能であることを保証しません。変更可能な結果が必要なら、コピーしてから追加する方法を使ってください。周囲のコードですでにストリームを使っている場合には便利です。変更可能な結果を簡潔に作る場合は、コピーして追加する方法のほうが、結果の作り方が明確です。ストリームを使う方法でも、入力リストの構造は変わりません。

コードと出力はバイト単位で保持されるため、出力に表示される色名は英語のままです。

import java.util.Arrays;
import java.util.List;
import java.util.stream.Collectors;
import java.util.stream.Stream;

public class Main {
    public static void main(String[] args) {
        List<String> first = Arrays.asList("red", "green");
        List<String> second = Arrays.asList("blue", "gold");

        List<String> combined = Stream.concat(first.stream(), second.stream())
                .collect(Collectors.toList());
        System.out.println(combined);
    }
}
[red, green, blue, gold]

Stream.concat()が結合するのは2つのストリームであり、それ自体がListを返すわけではありません。終端操作のcollect()がストリームを消費してリストを作成します。終端操作の後で同じストリームを再利用しないでください。入力リストはその後も別の操作に利用できます。

既存のリストにaddAll()で追加する

最初のリストを追加先にする場合は、first.addAll(second)を呼び出します。別の結果リストを作らずに済みますが、secondのすべての要素が追加され、firstが変更されます。追加先の変更が意図したものであり、そのリストが変更をサポートしている場合にだけ使ってください。固定サイズのリストや変更不可のリストには要素を追加できません。追加先が変更可能かどうか分からない場合は、新しいArrayListにコピーしてから追加してください。

コードと出力はバイト単位で保持されるため、出力に表示される色名は英語のままです。

import java.util.ArrayList;
import java.util.Arrays;
import java.util.List;

public class Main {
    public static void main(String[] args) {
        List<String> first = new ArrayList<>(Arrays.asList("red", "green"));
        List<String> second = Arrays.asList("blue", "gold");

        first.addAll(second);
        System.out.println(first);
    }
}
[red, green, blue, gold]

2つ目のリストは追加する要素の読み取り元として使われます。この呼び出しによって、2つ目のリストに要素が追加されることはありません。

方法を選び、リストの動作を理解する

独立した変更可能な結合リストが必要で、元のリストの要素順を保ちたい場合は、コピーしてから追加する方法を選びます。ストリーム処理との組み合わせでコードが分かりやすくなる場合は、Stream.concat()を使い、リストが必要なら結果を収集します。最初のリストを意図的に追加先として使い、それが変更可能な場合は、直接addAll()を呼び出します。

3つの方法はいずれも要素を連結するもので、重複を削除したり要素を並べ替えたりはしません。firstの末尾にある要素がsecondの先頭にもある場合、両方の要素が残り、2つ目の要素は最初のリストの全要素の後に並びます。重複を削除したり順序を変えたりするには、その要件に合った別の操作を適用してください。これらの方法が結合するのはリストの内容であり、格納されたオブジェクトを統合したり複製したりするわけではありません。