HOWTO · Java
Arreglar Java.Lang.StringIndexOutOfBoundsException: índice de cadena fuera de rango
Este artículo explica por qué `charAt(0)` falla cuando la cadena está vacía y cómo evitarlo comprobando su longitud. También resume los límites válidos de los índices y el uso de `try-catch` para gestionar la excepción cuando corresponda.
En esta página
Si se llama a charAt(0) en una cadena vacía, Java lanza StringIndexOutOfBoundsException porque no existe ningún carácter en el índice 0. Comprueba la longitud de la cadena antes de leer un carácter. En cualquier cadena no vacía, los índices válidos van de 0 a length() - 1.
Cómo corregir el error java.lang.StringIndexOutOfBoundsException: String index out of range
Los índices de las cadenas en Java empiezan en cero. Una cadena de longitud n tiene caracteres en los índices del 0 al n - 1; un índice igual a length() ya está fuera de rango. Por eso falla charAt(0) cuando la cadena está vacía. El ejemplo mínimo es String value = ""; value.charAt(0);: pide a Java un carácter que la cadena no contiene. Este fragmento ilustra la causa; no implica que se haya generado un rastro de excepción ni que se haya ejecutado el código.
El siguiente programa usa una cadena fija para mostrar cómo obtener correctamente el primer carácter. Mantiene juntos el dato y el acceso, de modo que se vea con claridad la relación entre el contenido de la cadena y el carácter obtenido. En un método real, la cadena podría proceder de un formulario, un archivo, una respuesta de red u otro método. En todos los casos se aplica la misma regla: usa un índice solo después de comprobar que la cadena contiene un carácter en esa posición. Ejecuta este ejemplo:
class StringIndexExample {
public static void main(String[] args) {
String value = "DelftStack";
System.out.println(value.charAt(0));
}
}
D
Para el índice 0, comprueba que la cadena no esté vacía antes de acceder a ella. La versión protegida de abajo muestra un mensaje alternativo cuando el valor no tiene un primer carácter. En esa rama evita llamar a charAt(0); en la otra, lee el primer carácter. La salida mostrada corresponde a la ejecución suministrada del ejemplo; la etiqueta del mensaje alternativo permanece en inglés porque el bloque de código se conserva sin cambios.
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
Si el índice procede de la entrada del usuario, valida su valor antes de usarlo. Para una cadena de longitud n, acepta un índice de carácter solo si se cumple 0 <= index && index < n. Si el índice se obtiene analizando texto, conviértelo primero y decide cómo debe responder la aplicación si el texto no es un número. Después comprueba el rango respecto de la cadena que vas a leer: verificar una cadena y luego leer otra, o una que haya cambiado, puede dejar obsoleta la comprobación. Si quien llama al método necesita un carácter predeterminado, elige uno con un significado definido en la aplicación, como un marcador documentado. Si no existe un valor predeterminado adecuado, devuelve un estado, pide que se corrija la entrada o prescinde de la operación en vez de sustituir datos silenciosamente.
Otras operaciones con cadenas tienen límites relacionados, pero no idénticos. substring(beginIndex) admite 0 <= beginIndex <= length(). Para substring(beginIndex, endIndex) y subSequence(beginIndex, endIndex), exige 0 <= beginIndex <= endIndex <= length(); el índice final es exclusivo, por lo que puede ser igual a la longitud de la cadena. String.valueOf(charArray, offset, count) exige que offset y count sean no negativos y que el rango solicitado quepa en la matriz. Estos métodos pueden lanzar StringIndexOutOfBoundsException si no se cumplen sus límites. Comprueba los argumentos específicos de cada operación en lugar de suponer que todos los métodos de cadenas usan los mismos límites.
StringIndexOutOfBoundsException es una excepción no comprobada, así que un método no tiene que declararla. Un bloque try-catch puede ser apropiado si un índice incorrecto e inesperado procede de un límite que no puedes validar antes, o si necesitas recuperarte en esa capa. No debe sustituir las comprobaciones habituales de entrada y de límites: capturar el fallo después del acceso no hace que el carácter solicitado exista. Para investigar un fallo comunicado en el índice 0, revisa dónde se crea la cadena, si el recorte o el análisis la modificaron y qué rama llega al acceso. El mensaje de la excepción y el rastro de ejecución pueden variar entre versiones de Java; compara el índice real con la length() actual de la cadena en vez de depender del texto exacto del rastro.