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.