База знанияИзпитен център
BGБългарски
Избери език13

CKTIS / Java

Character.charCount — брой UTF-16 кодови единици

Character.charCount(int codePoint) връща броя char единици, необходими за представяне на кодова точка в UTF-16: 1 или 2. Методът не проверява аргумента си, затова резултатът не потвърждава, че стойността е Unicode кодова точка.

Версия: Java SE 21; repository runtime, production runtime not attested

Синтаксис

public static int charCount(int codePoint)

Character.charCount(int codePoint) е статичен метод, който връща int. За валидна кодова точка той определя броя UTF-16 кодови единици (char): стойностите от BMP (U+0000–U+FFFF) използват една, а допълнителните кодови точки (U+10000–U+10FFFF) използват две, образувайки сурогатна двойка.

Точното правило е codePoint >= 0x10000 ? 2 : 1. Методът не проверява аргумента си: връща 1 за -1 и 2 за 0x110000, въпреки че и двете стойности са извън диапазона на Unicode кодовите точки. При нужда проверете диапазона с Character.isValidCodePoint(codePoint).

Не бъркайте броя на единиците char с броя на кодовите точки в текст: методът приема една стойност int, а не цял низ. Сурогатна стойност като 0xD800 също дава 1; самостоятелен сурогат обаче не представлява знак.

Примерът показва обикновена BMP кодова точка, границата между една и две единици, допълнителна кодова точка и два аргумента извън диапазона. Очакваният изход илюстрира както правилото за броене, така и липсата на проверка.

Примери

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));
        }
    }
}

Резултат

65 -> 1
65535 -> 1
65536 -> 2
128512 -> 2
-1 -> 1
1114112 -> 2

Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.

Източници