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.