Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / Java

String.charAt — čtení jednotky kódu UTF-16

String.charAt(int index) vrací char na indexu počítaném od nuly. Čte jednotku kódu UTF-16, nikoli nutně celý znak Unicode.

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

Syntaxe

public char charAt(int index)

String.charAt(int index) vrací char, tedy jednotku kódu UTF-16. Platný index splňuje 0 <= index && index < text.length(). První jednotka má index 0.

Záporný index nebo index rovný či větší než length() způsobí IndexOutOfBoundsException. Prázdný řetězec nemá žádný platný index.

Znak mimo BMP je v UTF-16 reprezentován párem zástupných jednotek. charAt vrací pouze jednu jednotku z této dvojice. V příkladu text.charAt(1) vrátí horní zástupnou jednotku; text.codePointAt(1) přečte celý kódový bod. Obě metody používají indexy jednotek kódu UTF-16.

Příklady

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

Výsledek

A
4
55357
128512

Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.

Zdroje