CKTIS / Java
Character.charCount — počet jednotiek kódu UTF-16
Character.charCount(int codePoint) vracia počet jednotiek char potrebných na reprezentáciu bodu kódu v UTF-16: 1 alebo 2. Metóda argument nekontroluje, takže jej výsledok nepotvrdzuje, že hodnota je bodom kódu Unicode.
Verzia: Java SE 21; repository runtime, production runtime not attested
Syntax
public static int charCount(int codePoint)Character.charCount(int codePoint) je statická metóda, ktorá vracia hodnotu int. Pre platný bod kódu určuje počet jednotiek kódu UTF-16 (char): hodnoty BMP (U+0000–U+FFFF) zaberú jednu jednotku, kým doplnkové body kódu (U+10000–U+10FFFF) zaberú dve a vytvoria náhradnú dvojicu.
Presné pravidlo je codePoint >= 0x10000 ? 2 : 1. Metóda argument nekontroluje: pre -1 vracia 1 a pre 0x110000 2, hoci obe hodnoty sú mimo rozsahu bodov kódu Unicode. V prípade potreby skontrolujte rozsah pomocou Character.isValidCodePoint(codePoint).
Nezamieňajte počet jednotiek char s počtom bodov kódu v texte: metóda prijíma jednu hodnotu int, nie celý reťazec. Hodnota náhradného znaku, napríklad 0xD800, tiež vráti 1; samostatný náhradný znak však nereprezentuje znak.
Príklad ukazuje bežný bod kódu BMP, hranicu medzi jednou a dvoma jednotkami, doplnkový bod kódu a dva argumenty mimo rozsahu. Očakávaný výstup znázorňuje pravidlo počítania aj chýbajúcu kontrolu.
Príklady
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));
}
}
}Výsledok
65 -> 1 65535 -> 1 65536 -> 2 128512 -> 2 -1 -> 1 1114112 -> 2
Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.