Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / Java

String.length — długość w jednostkach UTF-16

String.length() zwraca liczbę jednostek kodowych UTF-16, niekoniecznie liczbę znaków widocznych dla użytkownika.

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

Składnia

public int length()
text.length()

String.length to metoda instancji: wywołanie text.length() nie przyjmuje argumentów i zwraca int. Dla pustego napisu wynik wynosi 0.

Metoda liczy jednostki kodowe UTF-16, czyli wartości char. Znak spoza podstawowej płaszczyzny Unicode zajmuje parę surogatów, więc zwiększa wynik o 2. Nie traktuj tego wyniku jako liczby znaków widocznych dla użytkownika.

Do liczenia punktów kodowych służy text.codePointCount(0, text.length()). W przykładzie A i emoji dają długość 3, ale dwa punkty kodowe.

Przykłady

public class Main {
    public static void main(String[] args) {
        String text = "A\uD83D\uDE00";
        System.out.println(text.length());
        System.out.println(text.codePointCount(0, text.length()));
        System.out.println("".length());
    }
}

Wynik

3
2
0

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

Źródła