HOWTO · Java

Java.Lang.StringIndexOutOfBoundsException: String Index Out of Range を修正

Javaで空文字列に対して `charAt(0)` を呼び出すと、なぜ `StringIndexOutOfBoundsException` が発生するのかを解説します。インデックスの有効範囲を確認し、文字列の長さを検証してから安全に文字へアクセスする方法を紹介します。

このページの内容

空文字列に対して charAt(0) を呼び出すと、インデックス0に文字がないため、Javaは StringIndexOutOfBoundsException をスローします。文字を読み取る前に、文字列の長さを確認してください。空でない文字列で有効な文字インデックスは、0から length() - 1 までです。

java.lang.StringIndexOutOfBoundsException: String index out of range エラーを修正する

Javaの文字列インデックスは0から始まります。長さが n の文字列で有効な文字インデックスは0から n - 1 までで、length() と同じインデックスは範囲外です。そのため、文字列が空の場合は charAt(0) を呼び出せません。最小限の例は String value = ""; value.charAt(0); です。このコードは、文字列に存在しない文字を取得しようとしています。この断片は原因を説明するためのもので、例外トレースや実行結果を示すものではありません。

次のプログラムでは固定の文字列を使い、有効な先頭文字の取得方法を示します。入力とアクセスをまとめているため、文字列の内容と返される文字の関係が分かります。実際のメソッドでは、文字列がフォーム、ファイル、ネットワーク応答、別のメソッドなどから渡されることもあります。どの場合も、対象の位置に文字があると確認してからインデックスを使うというルールは同じです。次の例を実行してください。

class StringIndexExample {
    public static void main(String[] args) {
        String value = "DelftStack";
        System.out.println(value.charAt(0));
    }
}
D

インデックス0を使う場合は、アクセスする前に文字列が空でないことを確認します。次のガード付きの例では、値に先頭文字がない場合に代替メッセージを出力します。その分岐では charAt(0) を呼び出さず、もう一方の分岐では先頭文字を読み取ります。表示される出力ラベルは英語のままです。出力は、提供された実行結果に基づいています。

class SafeStringIndexExample {
    public static void main(String[] args) {
        String value = "";
        if (!value.isEmpty()) {
            System.out.println(value.charAt(0));
        } else {
            System.out.println("No character at index 0");
        }
    }
}
No character at index 0

インデックスがユーザー入力に由来する場合は、使う前に値を検証してください。長さが n の文字列では、0 <= index && index < n を満たす場合に限り、文字インデックスとして使用できます。インデックスをテキストから読み取る場合は、まず数値に変換し、そのテキストが数値でないときにアプリケーションがどう対応するかを決めます。その後、実際に読み取る文字列に対して範囲を確認してください。別の文字列や変更後の文字列を使うと、事前の確認が当てはまらなくなることがあります。呼び出し側で既定の文字が必要なら、文書化された代替文字など、アプリケーション内で意味が定まっているものを選びます。適切な既定値がない場合は、値を黙って置き換えず、状態を返す、入力の修正を求める、または処理をスキップしてください。

ほかの文字列操作にも関連する境界条件がありますが、それぞれ条件は異なります。substring(beginIndex) で指定できるのは 0 <= beginIndex <= length() です。substring(beginIndex, endIndex) と subSequence(beginIndex, endIndex) では、0 <= beginIndex <= endIndex <= length() を満たす必要があります。終了インデックスは範囲に含まれないため、文字列の長さと同じ値を指定できます。String.valueOf(charArray, offset, count) では、offset と count が0以上で、指定範囲が配列内に収まっていなければなりません。これらの境界条件を満たさない場合、各メソッドは StringIndexOutOfBoundsException をスローすることがあります。すべての文字列操作で同じ境界条件が使われると考えず、操作ごとの引数を確認してください。

StringIndexOutOfBoundsException は非チェック例外なので、メソッドで宣言する必要はありません。事前に検証できない境界から予期しない不正なインデックスが渡される場合や、その層で復旧する必要がある場合は、try-catch が適切なこともあります。ただし、通常の入力検証や範囲チェックの代わりにはなりません。アクセス後に例外を捕捉しても、要求した位置に文字が存在するようにはなりません。インデックス0で失敗した原因を調べるには、文字列の生成元、トリミングや解析による内容の変化、アクセスに至る分岐を確認してください。例外メッセージやスタックトレースはJavaのバージョンによって異なることがあるため、特定の文言に頼らず、実際のインデックスを現在の文字列の length() と比較します。