Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / Java

String.substring — wycinanie fragmentu tekstu

String.substring zwraca fragment tekstu bez zmiany oryginału. Początek jest włączony do zakresu, a koniec wyłączony; indeksy liczą jednostki UTF-16.

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

Składnia

String substring(int beginIndex)
String substring(int beginIndex, int endIndex)

String.substring(beginIndex, endIndex) zwraca zakres [beginIndex, endIndex) o długości endIndex - beginIndex. Indeksy zaczynają się od zera. String.substring(beginIndex) zwraca fragment do końca tekstu. Oryginał pozostaje niezmieniony.

Wymagane jest 0 <= beginIndex <= endIndex <= length(). Wariant jednoargumentowy wymaga 0 <= beginIndex <= length(). Naruszenie granic powoduje IndexOutOfBoundsException. Równe granice, także na końcu tekstu, dają pusty ciąg.

Indeksy liczą jednostki UTF-16 (char), niekoniecznie całe znaki Unicode. Granica może rozdzielić parę surogatów; nie traktuj tych indeksów jako pozycji znaków widocznych dla użytkownika.

Przykłady

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

Wynik

bcd
ef
true
abcdef

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

Źródła