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
Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.