Java “StringIndexOutOfBoundsException” hatası, bir metindeki geçerli karakter aralığının dışında kalan indekse erişmeye çalıştığında oluşur. Çözüm için indekslerin 0’dan başladığını, son geçerli indeksin length() - 1 olduğunu ve charAt() ile substring() çağrılarında sınırların kontrol edilmesi gerektiğini bilmelisin.
Özellikle döngülerde kullanılan koşul, boş metinler ve indexOf() sonucunun -1 olabilmesi bu hatanın yaygın nedenlerindendir. Hata mesajına güvenmeden önce, erişilmeye çalışılan indeksin gerçekten metnin sınırları içinde olup olmadığını kod üzerinden kontrol etmek daha sağlıklıdır.
StringIndexOutOfBoundsException neden oluşur?
Bu hata, bir String üzerinde geçerli aralığın dışındaki indekse erişildiğinde oluşur. Java’da String indeksleri 0’dan başlar ve length() metindeki karakter sayısını döndürür. Bu nedenle son geçerli indeks her zaman length() - 1 değeridir.
Örneğin "Java" metninin uzunluğu 4’tür. Geçerli indeksler 0, 1, 2 ve 3 olarak sıralanır. 4, karakter sayısını ifade eder ancak bir karaktere karşılık gelmediği için geçerli bir indeks değildir.
kelime.charAt(0), ilk karakteri verir.kelime.charAt(3),"Java"metnindeki son karakteri verir.kelime.charAt(4), son geçerli indeksi aştığı için hata oluşturur.kelime.charAt(-1), negatif indeks kullanıldığı için geçersizdir.
Boş bir String’in uzunluğu 0 olduğu için charAt(0) çağrısı da geçersizdir. Böyle bir metinde son geçerli indeks length() - 1 hesabıyla -1 olur ve kullanılabilecek bir karakter indeksi bulunmaz.
substring(begin, end) kullanırken begin değeri end değerini aşamaz ve end değeri metnin uzunluğundan büyük olamaz. Ayrıca end sınırı, alınan parçanın içine dâhil edilmez. Örneğin "Java".substring(1, 3) çağrısı, 1 ve 2 indekslerindeki karakterleri alarak "av" sonucunu üretir.
ArrayIndexOutOfBoundsException dizi elemanlarının sınırlarıyla, StringIndexOutOfBoundsException ise String içindeki karakter indeksleriyle ilgilidir.
charAt() döngüsündeki sınır hatası nasıl düzeltilir?

Bir döngü, String uzunluğuna eşit olan indeksi de kullanmaya çalışırsa son geçerli indeksi aşabilir. Tersten yazdırma işleminde bu durum, charAt() içine gönderilen indeksin son adımda -1 değerine düşmesine yol açabilir.
Aşağıdaki hatalı programda i <= kelime.length() koşulu kullanılıyor:
public class TersYazdirma {
public static void main(String[] args) {
String kelime = "Java";
for (int i = 0; i <= kelime.length(); i++) {
System.out.print(kelime.charAt(kelime.length() - i - 1));
}
}
}
Döngü 0’dan 4’e kadar çalışır. İlk dört adımda indeksler 3, 2, 1 ve 0 olur; bu nedenle ekrana avaJ yazdırılır. i değeri 4 olduğunda hesaplama 4 - 4 - 1 sonucuyla -1 üretir ve charAt(-1) çağrısı hataya neden olur.
Döngünün String uzunluğuna eşit indeksi kullanmasına gerek olmadığı için koşul i < kelime.length() biçiminde yazılmalıdır:
public class TersYazdirma {
public static void main(String[] args) {
String kelime = "Java";
for (int i = 0; i < kelime.length(); i++) {
System.out.print(kelime.charAt(kelime.length() - i - 1));
}
}
}
Bu sürümün çıktısı avaJ olur ve döngü, geçerli karakter indeksleri tükendiğinde durur.
i değeri |
charAt() indeksi |
Karakter |
|---|---|---|
| 0 | 3 | a |
| 1 | 2 | v |
| 2 | 1 | a |
| 3 | 0 | J |
Her döngü adımında kullanılan değişken ile String indeksi arasındaki ilişkiyi bu şekilde izlemek, sınırın hangi adımda aşıldığını görmeyi kolaylaştırır.
substring() ile e-posta bölümü nasıl güvenle alınır?

substring(0, at) çağrısı, @ karakterinin indeksini end sınırı olarak kullanarak işaretten önceki bölümü alır. substring() metodunda ikinci parametre aralığa dahil edilmediği için @ karakteri sonuç metnine eklenmez. Bunun çalışması için önce indexOf('@') sonucunun kontrol edilmesi gerekir.
indexOf('@'), aranan karakter bulunamadığında -1 döndürür. Bu değer doğrudan substring(0, at) içinde kullanılırsa başlangıç sınırı ile bitiş sınırı arasında geçersiz bir aralık oluşur. Bu nedenle at == -1 durumunda metin bölme işlemi yapılmamalıdır.
public class EmailUserName {
public static void main(String[] args) {
String email = "[email protected]";
int at = email.indexOf('@');
if (at == -1) {
System.out.println("E-posta adresinde @ karakteri bulunamadı.");
} else {
String kullaniciAdi = email.substring(0, at);
System.out.println(kullaniciAdi);
}
}
}
Bu programda at değişkeni @ karakterinin konumunu tutar. substring(0, at) çağrısı sıfırıncı indexten başlayıp at indeksine gelmeden durduğu için ekrana ogrenci yazdırır. Örneğin metin.substring(5, 2) ifadesinde begin değeri end değerinden büyük olduğu için geçersiz bir aralık oluşur. metin.substring(0, metin.length() + 1) ifadesinde ise end değeri metnin uzunluğunu aştığından aynı türden bir sınır hatası meydana gelir.
Hata mesajındaki indeks ve length bilgisi nasıl okunur?
Hata mesajındaki indeks ve uzunluk bilgileri, hangi değerin geçerli aralığın dışına çıktığını anlamaya yardım eder. charAt() kullanıldığında indeks, okunmak istenen karakterin konumunu; length ise metindeki karakter sayısını ifade eder. Geçerli karakter indeksleri sıfırdan başlayarak length() - 1 değerine kadar ilerler.
substring() kaynaklı bir mesajda begin başlangıç konumunu, end bitiş sınırını, length ise metnin toplam uzunluğunu gösterir. Burada begin değerinin end değerinden büyük olmaması ve end değerinin metnin uzunluğunu aşmaması gerekir. Hata mesajının ayrıntılı metni ve alanların yazılış biçimi JDK sürümüne göre farklı görünebilir; bu yüzden sınıf adına ve değerlerin anlamına odaklanmak daha güvenlidir.
| işlem | mesajdaki değer | kontrol edilecek koşul |
|---|---|---|
charAt(index) |
index ve varsa length |
0 <= index < length() |
substring(begin, end) |
begin, end ve varsa length |
0 <= begin <= end <= length() |
indexOf() sonucu |
Aranan karakter bulunamadığında -1 |
-1 değeri sınır olarak kullanılmadan önce kontrol edilmeli |
ArrayIndexOutOfBoundsException benzer bir indeks problemini dizilerde gösterir; StringIndexOutOfBoundsException ise metin işlemlerindeki sınır kullanımını ifade eder. Bu ayrım, hatanın hangi veri yapısında oluştuğunu hızlıca belirlemeyi sağlar.
Bu hata yeniden oluşmadan önce neler kontrol edilir?
String işlemi yapmadan hemen önce metnin boş olup olmadığını ve kullanılacak indeksin 0 ile length() - 1 arasında bulunup bulunmadığını kontrol etmek, StringIndexOutOfBoundsException hatasını önlemeye yardımcı olur. Her metot için sınır koşulunu ayrıca değerlendirmek gerekir.
charAt()çağrısından önce String'in boş olmadığını, indeksin 0 veya daha büyük velength()değerinden küçük olduğunu kontrol et.substring(begin, end)kullanırkenbegin <= endveend <= length()koşullarını sağla.indexOf()sonucunu doğrudan bölme işleminde kullanma. Sonuç-1ise aranan ifade bulunamamıştır vesubstring()çağrısı ertelenmelidir.
Scanner ile okunan satır, kullanıcı yalnızca Enter tuşuna bastığında boş olabilir. Bu nedenle charAt(0) çağrısından önce isEmpty() kontrolü yapılabilir:
import java.util.Scanner;
public class Main {
public static void main(String[] args) {
Scanner scanner = new Scanner(System.in);
String line = scanner.nextLine();
if (!line.isEmpty()) {
System.out.println(line.charAt(0));
} else {
System.out.println("Metin boş.");
}
}
}
Boş bir satır girildiğinde program charAt(0) çağrısı yapmadan “Metin boş.” mesajını yazdırır. Böylece boş String'in ilk karakterine erişilmeye çalışılmaz.
| işlem | çağrıdan önce kontrol | sık hata |
|---|---|---|
charAt(index) |
String boş mu, 0 <= index < length() koşulu sağlanıyor mu? |
charAt(length()) kullanmak |
substring(begin, end) |
begin <= end ve end <= length() mı? |
end değerini String uzunluğunu aşacak şekilde vermek |
indexOf() sonrası bölme |
Sonuç -1 mi, geçerli bir indeks mi? |
Bulunamayan ifadeden sonra substring(-1) çağırmak |
Hatanın kaynağını bulmak için önce istisnanın alındığı satırı belirle. Ardından o satırda kullanılan indeksi, ilgili String'in length() değerini ve girişin boş gelme ihtimalini birlikte incele. Değerleri geçici olarak yazdırmak, sınırın hangi noktada aşıldığını görmeyi kolaylaştırır. Java temellerini düzenli bir sırayla çalışmak isteyenler, Java birebir özel ders programı içeriğini de inceleyebilir.
- İstisnanın oluştuğu String çağrısını belirle.
- İndeks veya
begin,enddeğerlerini kontrol et. - String'in uzunluğunu ve boş olup olmadığını ölç.
indexOf()kullanıldıysa-1kontrolünü ara.- Girişin boş satır olarak gelmesi ihtimalini değerlendir.
ArrayIndexOutOfBoundsException benzer bir sınır ihlalini dizilerde gösterir; StringIndexOutOfBoundsException ise metin indeksleriyle ilgili çağrılarda ortaya çıkar.
Sık Sorulan Sorular
Java String indeksleri neden 0'dan başlar?
Java'da String içindeki ilk karakter 0 indeksinde tutulur, çünkü indeks karakterin metin içindeki konumunu ilk elemandan başlayarak sayar. Bu nedenle son geçerli indeks her zaman length() - 1 değeridir.
substring(begin, end) metodunda end değeri neden sonuca dahil edilmez?
substring(begin, end) metodu begin indeksinden başlar ve end indeksinden hemen önce durur. Böylece substring(0, 3) çağrısı 0, 1 ve 2 indekslerindeki karakterleri alır.
indexOf() -1 döndürürse substring() çağrısı nasıl güvenli yapılır?
indexOf() sonucu 0 veya daha büyükse substring() çağrısı yapılmalı, sonuç -1 ise aranan ifade bulunamadığı için bölme işlemi ertelenmelidir.
Scanner ile okunan metin boşsa charAt(0) çağrısından önce ne kontrol edilmelidir?
charAt(0) çağrısından önce String'in isEmpty() ile boş olup olmadığı kontrol edilmelidir. Metin boşsa karakter okumak yerine uygun bir akış işletilmelidir.
String sınırlarını her çağrıdan önce kontrol etmek, metin işlemlerini daha öngörülebilir ve hata ayıklaması daha kolay hâle getirir.