CKTIS / Java
String.substring — einen Teil eines Strings extrahieren
String.substring gibt einen Teil eines Strings zurück, ohne das Original zu ändern. Der Anfang ist eingeschlossen, das Ende ausgeschlossen; Indizes zählen UTF-16-Codeeinheiten.
Version: Java SE 21; repository runtime, production runtime not attested
Syntax
String substring(int beginIndex)
String substring(int beginIndex, int endIndex)String.substring(beginIndex, endIndex) gibt den Bereich [beginIndex, endIndex) mit der Länge endIndex - beginIndex zurück. Die Indizes beginnen bei null. String.substring(beginIndex) gibt den Rest bis zum Ende zurück. Das Original bleibt unverändert.
Es muss 0 <= beginIndex <= endIndex <= length() gelten. Die Variante mit einem Argument erfordert 0 <= beginIndex <= length(). Ungültige Grenzen führen zu IndexOutOfBoundsException. Gleiche Grenzen, auch am Ende, ergeben einen leeren String.
Indizes zählen UTF-16-Codeeinheiten (char), nicht unbedingt vollständige Unicode-Zeichen. Eine Grenze kann ein Surrogatpaar teilen; behandle diese Indizes nicht als Positionen von für Menschen wahrgenommenen Zeichen.
Beispiele
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);
}
}Ergebnis
bcd ef true abcdef
Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.