Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

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.

Izvori