Java : StringIndexOutOfBoundsException - API使用例

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

概要

Stringメソッドによりスローされ、インデックスが負または文字列のサイズより大きいことを示します。 charAtメソッドなどの一部のメソッドでは、索引が文字列のサイズと等しい場合もこの例外がスローされます。

クラス構成

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

final var str = "abc";

System.out.println(str.charAt(0)); // a
System.out.println(str.charAt(1)); // b
System.out.println(str.charAt(2)); // c

try {
    final var ret = str.charAt(3);
} catch (StringIndexOutOfBoundsException e) {
    System.out.println(e);
}

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

コンストラクタ

StringIndexOutOfBoundsException ()

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

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

StringIndexOutOfBoundsException (int index)

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

final var e = new StringIndexOutOfBoundsException(123);

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

StringIndexOutOfBoundsException (String s)

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

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

Throwableで宣言されたメソッド

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

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

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

API 使用例