CKTIS / Java
Character.charCount — broj UTF-16 kodnih jedinica
Character.charCount(int codePoint) vraća broj jedinica char potrebnih za prikaz kodne točke u UTF-16: 1 ili 2. Metoda ne provjerava argument pa njezin rezultat ne potvrđuje da je vrijednost kodna točka Unicodea.
Verzija: Java SE 21; repository runtime, production runtime not attested
Sintaksa
public static int charCount(int codePoint)Character.charCount(int codePoint) statička je metoda koja vraća int. Za valjanu kodnu točku određuje broj UTF-16 kodnih jedinica (char): vrijednosti BMP-a (U+0000–U+FFFF) zauzimaju jednu, a dopunske kodne točke (U+10000–U+10FFFF) dvije jedinice koje čine surogatni par.
Točno pravilo glasi codePoint >= 0x10000 ? 2 : 1. Metoda ne provjerava argument: za -1 vraća 1, a za 0x110000 2, iako su obje vrijednosti izvan raspona kodnih točaka Unicodea. Po potrebi provjerite raspon pomoću Character.isValidCodePoint(codePoint).
Nemojte miješati broj jedinica char s brojem kodnih točaka u tekstu: metoda prima jednu vrijednost int, a ne cijeli niz. Surogatna vrijednost poput 0xD800 također daje 1; međutim, izolirani surogat ne predstavlja znak.
Primjer prikazuje običnu kodnu točku BMP-a, granicu između jedne i dvije jedinice, dopunsku kodnu točku i dva argumenta izvan raspona. Očekivani izlaz prikazuje i pravilo brojanja i izostanak provjere.
Primjeri
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));
}
}
}Rezultat
65 -> 1 65535 -> 1 65536 -> 2 128512 -> 2 -1 -> 1 1114112 -> 2
Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.