Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

CKTIS / Java

Character.charCount — število kodnih enot UTF-16

Character.charCount(int codePoint) vrne število enot char, potrebnih za predstavitev kodne točke v UTF-16: 1 ali 2. Metoda argumenta ne preveri, zato njen rezultat ne potrjuje, da je vrednost kodna točka Unicode.

Različica: Java SE 21; repository runtime, production runtime not attested

Sintaksa

public static int charCount(int codePoint)

Character.charCount(int codePoint) je statična metoda, ki vrne int. Za veljavno kodno točko določi število kodnih enot UTF-16 (char): vrednosti BMP (U+0000–U+FFFF) zasedejo eno enoto, dodatne kodne točke (U+10000–U+10FFFF) pa dve in tvorijo nadomestniški par.

Natančno pravilo je codePoint >= 0x10000 ? 2 : 1. Metoda argumenta ne preveri: za -1 vrne 1, za 0x110000 pa 2, čeprav sta obe vrednosti zunaj obsega kodnih točk Unicode. Po potrebi preverite obseg z Character.isValidCodePoint(codePoint).

Števila enot char ne zamenjujte s številom kodnih točk v besedilu: metoda sprejme eno samo vrednost int, ne celotnega niza. Tudi nadomestniška vrednost, kot je 0xD800, vrne 1; osamljeni nadomestniški znak pa ne predstavlja znaka.

Primer prikazuje običajno kodno točko BMP, mejo med eno in dvema enotama, dodatno kodno točko in dva argumenta zunaj obsega. Pričakovani izpis ponazarja tako pravilo štetja kot odsotnost preverjanja.

Primeri

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

Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.

Viri