WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / Java

String.split — Text mit einem regulären Ausdruck aufteilen

String.split gibt ein Array mit Textabschnitten zurück, die durch Treffer eines regulären Ausdrucks getrennt sind. Der Parameter limit bestimmt die Anzahl der Aufteilungen und den Umgang mit leeren Elementen am Ende.

Version: Java SE 21; repository runtime, production runtime not attested

Syntax

String[] parts = text.split(regex);
String[] parts = text.split(regex, limit);

String.split gibt ein String[] mit den Textabschnitten in ihrer ursprünglichen Reihenfolge zurück, ohne die passenden Trennzeichen. Gibt es keinen Treffer, enthält das Ergebnis ein Element: den gesamten Eingabetext.

split(regex) entspricht split(regex, 0): Leere Elemente am Ende werden entfernt. Bei limit < 0 bleiben sie erhalten. Bei limit > 0 erfolgen höchstens limit - 1 Aufteilungen; das letzte Element enthält den restlichen Text, und das Array hat höchstens limit Elemente.

regex ist ein regulärer Ausdruck und kein einfaches Trennzeichen. Einen literalen Punkt schreibst du als "\\."; ein beliebiges literales Trennzeichen schützt du mit Pattern.quote(separator) aus java.util.regex.Pattern. Ein ungültiges Muster löst PatternSyntaxException aus.

Bei limit == 1 wird der Text nicht aufgeteilt, selbst wenn das Muster am Anfang einen Treffer liefert. Wird der Text an einem Treffer aufgeteilt, der Zeichen am Anfang verbraucht, entsteht ein leeres Element am Anfang. Ein Treffer der Breite null am Anfang erzeugt kein solches Element. Sind bei limit == 0 alle durch die Aufteilung entstandenen Elemente leer, werden sie alle entfernt, auch das erste. Beispielsweise gibt ",".split(",", 0) ein leeres Array zurück.

Beispiele

import java.util.Arrays;

public class Main {
    public static void main(String[] args) {
        String text = "red.blue..";
        System.out.println(Arrays.toString(text.split("\\.")));
        System.out.println(Arrays.toString(text.split("\\.", -1)));
        System.out.println(Arrays.toString(text.split("\\.", 2)));
    }
}

Ergebnis

[red, blue]
[red, blue, , ]
[red, blue..]

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