Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / Java

Character.charCount — liczba jednostek UTF-16

Character.charCount(int codePoint) zwraca liczbę jednostek char potrzebnych do reprezentacji punktu kodowego w UTF-16: 1 albo 2. Metoda nie sprawdza poprawności argumentu, więc jej wynik nie potwierdza, że wartość jest punktem kodowym Unicode.

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

Składnia

public static int charCount(int codePoint)

Character.charCount(int codePoint) to metoda statyczna zwracająca int. Dla poprawnego punktu kodowego określa liczbę jednostek kodowych UTF-16 (char): wartości z BMP (U+0000–U+FFFF) zajmują jedną, a punkty spoza BMP (U+10000–U+10FFFF) dwie, tworzące parę surogatów.

Dokładna reguła to codePoint >= 0x10000 ? 2 : 1. Metoda nie waliduje argumentu: dla -1 zwraca 1, a dla 0x110000 zwraca 2, mimo że obie wartości są poza zakresem punktów kodowych Unicode. W razie potrzeby sprawdź zakres za pomocą Character.isValidCodePoint(codePoint).

Nie myl liczby jednostek char z liczbą punktów kodowych w tekście: metoda przyjmuje pojedynczą wartość int, a nie cały napis. Wartość surogatu, na przykład 0xD800, również daje 1; samodzielny surogat nie reprezentuje jednak znaku.

Przykład pokazuje zwykły punkt BMP, granicę między jedną a dwiema jednostkami, punkt spoza BMP oraz dwa argumenty spoza zakresu. Oczekiwane wyjście ilustruje zarówno sposób liczenia, jak i brak walidacji.

Przykłady

public class Main {
    public static void main(String[] args) {
        int[] values = {0x0041, 0xFFFF, 0x10000, 0x1F600, -1, 0x110000};
        for (int codePoint : values) {
            System.out.println(codePoint + " -> " + Character.charCount(codePoint));
        }
    }
}

Wynik

65 -> 1
65535 -> 1
65536 -> 2
128512 -> 2
-1 -> 1
1114112 -> 2

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

Źródła