Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / Java

Character.charCount — nombre d’unités de code UTF-16

Character.charCount(int codePoint) renvoie le nombre d’unités char nécessaires pour représenter un point de code en UTF-16 : 1 ou 2. La méthode ne valide pas son argument ; son résultat ne confirme donc pas que la valeur est un point de code Unicode.

Version : Java SE 21; repository runtime, production runtime not attested

Syntaxe

public static int charCount(int codePoint)

Character.charCount(int codePoint) est une méthode statique qui renvoie un int. Pour un point de code valide, elle détermine le nombre d’unités de code UTF-16 (char) : les valeurs BMP (U+0000–U+FFFF) en utilisent une, tandis que les points de code supplémentaires (U+10000–U+10FFFF) en utilisent deux, formant une paire de substituts.

La règle exacte est codePoint >= 0x10000 ? 2 : 1. La méthode ne valide pas son argument : elle renvoie 1 pour -1 et 2 pour 0x110000, bien que ces deux valeurs soient hors de la plage des points de code Unicode. Si nécessaire, vérifiez la plage avec Character.isValidCodePoint(codePoint).

Ne confondez pas le nombre d’unités char avec le nombre de points de code dans un texte : la méthode accepte une seule valeur int, et non une chaîne entière. Une valeur de substitut telle que 0xD800 donne également 1 ; toutefois, un substitut isolé ne représente pas un caractère.

L’exemple montre un point de code BMP ordinaire, la limite entre une et deux unités, un point de code supplémentaire et deux arguments hors plage. Le résultat attendu illustre à la fois la règle de comptage et l’absence de validation.

Exemples

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

Résultat

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

Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.

Sources