CKTIS / Java
String.substring — extraer parte de una cadena
String.substring devuelve parte de una cadena sin cambiar la original. El inicio se incluye y el final se excluye; los índices cuentan unidades de código UTF-16.
Versión: Java SE 21; repository runtime, production runtime not attested
Sintaxis
String substring(int beginIndex)
String substring(int beginIndex, int endIndex)String.substring(beginIndex, endIndex) devuelve el intervalo [beginIndex, endIndex), cuya longitud es endIndex - beginIndex. Los índices empiezan en cero. String.substring(beginIndex) devuelve el sufijo hasta el final. La cadena original permanece sin cambios.
Se debe cumplir 0 <= beginIndex <= endIndex <= length(). La sobrecarga de un argumento requiere 0 <= beginIndex <= length(). Los límites no válidos provocan IndexOutOfBoundsException. Los límites iguales, también al final, producen una cadena vacía.
Los índices cuentan unidades de código UTF-16 (char), no necesariamente caracteres Unicode completos. Un límite puede dividir un par de sustitutos; no trates estos índices como posiciones de caracteres percibidos por el usuario.
Ejemplos
public class Main {
public static void main(String[] args) {
String text = "abcdef";
System.out.println(text.substring(1, 4));
System.out.println(text.substring(4));
System.out.println(text.substring(6).isEmpty());
System.out.println(text);
}
}Resultado
bcd ef true abcdef
El código mostrado y el resultado declarado se verificaron en un entorno aislado mediante el método registrado en la evidencia de verificación de esta versión exacta.