Java : ArrayIndexOutOfBoundsException - API使用例

ArrayIndexOutOfBoundsException (Java SE 21 & JDK 21) の使用例まとめです。
だいたいのメソッドを網羅済みです。
API仕様書のおともにどうぞ。

概要

不正なインデックスを使って配列がアクセスされたことを示すためにスローされます。つまり、インデックスが負または、配列のサイズ以上の場合です。

クラス構成

ArrayIndexOutOfBoundsException は、配列のインデックスが 範囲外 のときに発生する非チェック例外です。

final int[] array = {10, 20, 30};

System.out.println(array[0]); // 10
System.out.println(array[1]); // 20
System.out.println(array[2]); // 30

try {
    final var ret = array[3];
} catch (ArrayIndexOutOfBoundsException e) {
    System.out.println(e);
}

// 結果
// ↓
//java.lang.ArrayIndexOutOfBoundsException: Index 3 out of bounds for length 3

コンストラクタ

ArrayIndexOutOfBoundsException ()

詳細メッセージなしでArrayIndexOutOfBoundsExceptionを構築します。

final var e = new ArrayIndexOutOfBoundsException();
System.out.println(e); // java.lang.ArrayIndexOutOfBoundsException

ArrayIndexOutOfBoundsException (int index)

不正なインデックスを示す引数を持つ新しいArrayIndexOutOfBoundsExceptionクラスを構築します。

final var e = new ArrayIndexOutOfBoundsException(123);

// java.lang.ArrayIndexOutOfBoundsException: Array index out of range: 123
System.out.println(e);

ArrayIndexOutOfBoundsException (String s)

指定された詳細メッセージを持つArrayIndexOutOfBoundsExceptionクラスを構築します。

final var e = new ArrayIndexOutOfBoundsException("abcd");
System.out.println(e); // java.lang.ArrayIndexOutOfBoundsException: abcd

Throwableで宣言されたメソッド

addSuppressed, fillInStackTrace, getCause, getLocalizedMessage, getMessage, getStackTrace, getSuppressed, initCause, printStackTrace, printStackTrace, printStackTrace, setStackTrace, toString

「Java API 使用例 : Throwable」をご参照ください。

例外 vs. 戻り値でエラーチェック

API 使用例