【Java】ArrayListに要素を追加するArrayList.addメソッドについて解説します

こんにちは。たいら(@tairaengineer2)です。
転職を繰り返し現在4社経験している、11年目エンジニアです。

この記事では、 JavaでArrayListに要素を追加するArrayList.addメソッドについて

ArrayList.addメソッドとは
ArrayList.addメソッドを使ったサンプルプログラム

と、丁寧に解説していきます。

前提条件：実行環境について
ArrayList.addメソッドとは
1. パターン1：インデックスを指定しない場合
2. パターン2：インデックスを指定する場合
ArrayList.addメソッドを解説するプログラムの概要
Javaサンプルプログラム
実行結果
まとめ：ArrayList.addメソッドを使ってみよう！

前提条件：実行環境について

実行環境は以下の通りです。

OS	Windows10
IntelliJ IDEAのエディション	Community(無料版)
IntelliJ IDEAのバージョン	2021.3.2
プロジェクト	Javaプロジェクト
SDK	Oracle OpenJDK version17.0.2

Javaを動かすためにIntelliJ IDEAを使っています。
IntelliJ IDEAのインストールは、下の記事をご参考ください。

【IntelliJ IDEA】インストールするやり方を解説します（Windows向け）

ArrayList.addメソッドとは

ArrayList.addメソッドとは、ArrayListに引数で指定されている値を追加するメソッドです。
ArrayList.addメソッドを使うためには、

import java.util.ArrayList;

1	import java.util.ArrayList;

をインポートする必要があります。

ArrayList.addメソッドは使い方が

パターン1：インデックスを指定しない場合
パターン2：インデックスを指定する場合

の合計2パターンあります。
それぞれ解説します。

パターン1：インデックスを指定しない場合

インデックスを指定しないでArrayList.addメソッドを使った場合、引数の値はArrayListの最後に追加されます。
以下のように使います。

ArrayList<String> sample = new ArrayList<>();
sample.add("test");
sample.add("sample");

ArrayList<String> sample = new ArrayList<>();

sample.add("test");

sample.add("sample");

上記の例だと、変数sampleには

test
sample

1 2	test sample

という順で格納されています。

パターン2：インデックスを指定する場合

インデックスを指定してArrayList.addメソッドを使った場合、指定したインデックスで引数の値が挿入されます。
もし挿入された位置より後ろに要素が存在する場合、1つずつ後ろにずれます。

たとえばパターン1の

ArrayList<String> sample = new ArrayList<>();
sample.add("test");
sample.add("sample");

ArrayList<String> sample = new ArrayList<>();

sample.add("test");

sample.add("sample");

というArrayListに対して

sample.add(1, "hogehoge");

1	sample.add(1, "hogehoge");

と実行した場合、変数sampleには

test
hogehoge
sample

test

hogehoge

sample

と、1番目に「hogehoge」が挿入され元1番目の「sample」は1つ後ろにずれます。

注意点としてもし指定するインデックスがArrayListの要素数より大きい場合、コンパイルは通るものの実行すると

Exception in thread "main" java.lang.IndexOutOfBoundsException

1	Exception in thread "main" java.lang.IndexOutOfBoundsException

という例外が発生します。

では、次の章で実際に使ってみます。

ArrayList.addメソッドを解説するプログラムの概要

ArrayList.addメソッドを解説するプログラムでは、ArrayListを新規作成し

インデックス指定なし
インデックス指定あり

でそれぞれ要素を追加して、結果を表示させます。

解説で使うJavaプログラムは、Sampleプロジェクトのsampleパッケージ内にある、とします。
JavaのArrayList.addメソッドを解説

Javaサンプルプログラム

package sample;

import java.util.ArrayList;

public class Sample {
    public static void main(String[] args) {
        ArrayList<String> fruitList = new ArrayList<>();
        fruitList.add("リンゴ");
        fruitList.add("オレンジ");
        fruitList.add("ぶどう");

        System.out.println("■インデックス無しで追加");
        for (String fruit : fruitList) {
            System.out.println(fruit);
        }

        fruitList.add(1, "イチゴ");
        fruitList.add(4, "パイナップル");
        System.out.println("■インデックスありで追加");
        for (String fruit : fruitList) {
            System.out.println(fruit);
        }
    }
}

package sample;

import java.util.ArrayList;

public class Sample {

public static void main(String[] args) {

ArrayList<String> fruitList = new ArrayList<>();

fruitList.add("リンゴ");

fruitList.add("オレンジ");

fruitList.add("ぶどう");

System.out.println("■インデックス無しで追加");

for (String fruit : fruitList) {

System.out.println(fruit);

}

fruitList.add(1, "イチゴ");

fruitList.add(4, "パイナップル");

System.out.println("■インデックスありで追加");

for (String fruit : fruitList) {

System.out.println(fruit);

}

サンプルプログラムのfor文の書き方は、拡張for文と言います。
詳しくはこちらの記事をご参考ください。

【Java】拡張for文を解説します

実行結果

Javaプログラムを実行します。
実行のやり方は

プログラムを右クリックして実行
実行タブから実行
ガターから実行

の3種類あるので、いずれかで実行します。
詳しい解説は以下の記事をご参考ください。

【IntelliJ IDEA】Javaアプリケーションを実行するやり方を解説します

JavaでArrayListに要素を追加するaddメソッドを解説

■インデックス無しで追加
リンゴ
オレンジ
ぶどう
■インデックスありで追加
リンゴ
イチゴ
オレンジ
ぶどう
パイナップル

■インデックス無しで追加

リンゴ

オレンジ

ぶどう

■インデックスありで追加

リンゴ

イチゴ

オレンジ

ぶどう

パイナップル

インデックスを指定しなかった場合は最後に、指定した場合は指定した位置に要素が挿入できていることが確認できました。

まとめ：ArrayList.addメソッドを使ってみよう！

以上がJavaのArrayList.addメソッドについての解説でした！

あなたのご参考になったのなら、とても嬉しいです(*´▽｀*)
ではでは～(・ω・)ﾉｼ