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

CKTIS / Java

String.codePointAt — kódový bod na indexu UTF-16

String.codePointAt vrací int představující kódový bod, ale přijímá index jednotky kódu UTF-16, nikoli pořadové číslo kódového bodu.

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

Syntaxe

public int codePointAt(int index)

String.codePointAt(int index) čte hodnotu na indexu jednotky kódu UTF-16 (char). Výsledkem je int, na rozdíl od výsledku metody charAt.

Pokud je na zadaném indexu horní náhradní jednotka a bezprostředně za ní následuje dolní náhradní jednotka, metoda je spojí a vrátí odpovídající kódový bod. Jinak vrátí hodnotu char na zadaném indexu, i když jde o nespárovanou náhradní jednotku. Pokud index ukazuje na dolní náhradní jednotku, metoda se nevrací na začátek páru.

Musí platit 0 <= index && index < text.length(). Při porušení podmínky se vyvolá IndexOutOfBoundsException; prázdný řetězec nemá žádný platný index.

V příkladu zabírá pár \uD83D\uDE00 dvě pozice: pro index 1 metoda vrátí 128512, zatímco pro index 2 vrátí hodnotu dolní náhradní jednotky 56832.

Příklady

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

Výsledek

4
65
128512
56832

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