Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / Java

String.split — podział tekstu wyrażeniem regularnym

String.split zwraca tablicę fragmentów tekstu oddzielonych dopasowaniami wyrażenia regularnego. Parametr limit określa liczbę podziałów i zachowanie końcowych pustych elementów.

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

Składnia

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

String.split zwraca String[] w kolejności występowania fragmentów, bez dopasowanych separatorów. Gdy brak dopasowania, wynikiem jest jeden element: cały tekst.

split(regex) odpowiada split(regex, 0): usuwa końcowe puste elementy. Dla limit < 0 zachowuje je. Dla limit > 0 wykonuje najwyżej limit - 1 podziałów; ostatni element zawiera resztę tekstu, a tablica ma najwyżej limit elementów.

regex jest wyrażeniem regularnym, nie zwykłym separatorem. Kropkę zapisuj jako "\\.", a dowolny separator literalny zabezpiecz przez Pattern.quote(separator) z java.util.regex.Pattern. Niepoprawny wzorzec powoduje PatternSyntaxException.

Przy limit == 1 tekst nie jest dzielony, nawet jeśli wzorzec pasuje na początku. Jeśli do podziału dochodzi na dopasowaniu obejmującym znaki na początku tekstu, powstaje początkowy pusty element. Dopasowanie zerowej szerokości na początku go nie tworzy. Przy limit == 0, jeśli wszystkie elementy powstałe po podziale są puste, usuwa się je wszystkie, także pierwszy. Na przykład ",".split(",", 0) zwraca pustą tablicę.

Przykłady

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)));
    }
}

Wynik

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

Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.

Źródła