KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / Java

Character.charCount — aantal UTF-16-code-eenheden

Character.charCount(int codePoint) geeft het aantal char-eenheden terug dat nodig is om een codepoint in UTF-16 weer te geven: 1 of 2. De methode valideert het argument niet; het resultaat bevestigt dus niet dat de waarde een Unicode-codepoint is.

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

Syntax

public static int charCount(int codePoint)

Character.charCount(int codePoint) is een statische methode die een int teruggeeft. Voor een geldig codepoint bepaalt de methode het aantal UTF-16-code-eenheden (char): BMP-waarden (U+0000–U+FFFF) gebruiken er één, terwijl aanvullende codepoints (U+10000–U+10FFFF) er twee gebruiken en samen een surrogaatpaar vormen.

De exacte regel is codePoint >= 0x10000 ? 2 : 1. De methode valideert het argument niet: voor -1 geeft ze 1 terug en voor 0x110000 2, hoewel beide waarden buiten het bereik van Unicode-codepoints vallen. Controleer zo nodig het bereik met Character.isValidCodePoint(codePoint).

Verwar het aantal char-eenheden niet met het aantal codepoints in tekst: de methode accepteert één int-waarde, geen volledige tekenreeks. Ook een surrogaatwaarde zoals 0xD800 levert 1 op; een losse surrogaat stelt echter geen teken voor.

Het voorbeeld toont een gewoon BMP-codepoint, de grens tussen één en twee eenheden, een aanvullend codepoint en twee argumenten buiten het bereik. De verwachte uitvoer laat zowel de telregel als het ontbreken van validatie zien.

Voorbeelden

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

Resultaat

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

De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.

Bronnen