WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

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.

Quellen