KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / Java

String.codePointAt — codepoint op een UTF-16-index

String.codePointAt retourneert een int die een codepoint voorstelt, maar verwacht een index van een UTF-16-code-eenheid, niet een rangnummer van een codepoint.

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

Syntax

public int codePointAt(int index)

String.codePointAt(int index) leest de waarde op een index van een UTF-16-code-eenheid (char). Het resultaat is een int, anders dan bij charAt.

Is de geselecteerde eenheid een high surrogate, gevolgd door een low surrogate, dan combineert de methode het paar. Anders retourneert de methode de waarde van de geselecteerde char, ook bij een ongepaarde surrogate. Als je een low surrogate selecteert, zoekt de methode niet terug naar het begin van het paar.

De voorwaarde is 0 <= index && index < text.length(). Als hier niet aan wordt voldaan, wordt IndexOutOfBoundsException gegooid; een lege string heeft geen geldige index.

In het voorbeeld beslaat het paar \uD83D\uDE00 twee indices: index 1 levert 128512 op, terwijl index 2 de waarde van de low surrogate 56832 oplevert.

Voorbeelden

public class Main {
    public static void main(String[] args) {
        String text = "A\uD83D\uDE00B";
        System.out.println(text.length());
        System.out.println(text.codePointAt(0));
        System.out.println(text.codePointAt(1));
        System.out.println(text.codePointAt(2));
    }
}

Resultaat

4
65
128512
56832

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