KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / Java

String.charAt — een UTF-16-code-eenheid lezen

String.charAt(int index) geeft de char op een index vanaf nul terug. De methode leest een UTF-16-code-eenheid, niet noodzakelijk een volledig Unicode-teken.

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

Syntax

public char charAt(int index)

String.charAt(int index) geeft een char terug, oftewel een UTF-16-code-eenheid. Een geldige index voldoet aan 0 <= index && index < text.length(). De eerste eenheid heeft index 0.

Een negatieve index of een index die gelijk is aan of groter is dan length() veroorzaakt IndexOutOfBoundsException. Een lege tekenreeks heeft geen geldige index.

Een teken buiten het BMP neemt een surrogaatpaar in beslag. charAt geeft slechts één eenheid van dat paar terug. In het voorbeeld is text.charAt(1) de hoge surrogaat; text.codePointAt(1) leest het volledige codepunt. Beide methoden gebruiken indexen van UTF-16-code-eenheden.

Voorbeelden

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

Resultaat

A
4
55357
128512

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