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

CKTIS / Java

String.codePointBefore — kódový bod před indexem

String.codePointBefore vrací hodnotu Unicode před indexem jednotky UTF-16 a zohledňuje páry náhradních znaků.

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

Syntaxe

public int codePointBefore(int index)

String.codePointBefore(int index) vrací hodnotu typu int, která představuje kódový bod před index. Index počítá jednotky UTF-16 (char), nikoli kódové body; platný rozsah je 1 <= index && index <= length().

Pokud je bezprostředně před indexem dolní surogát (low surrogate) a přímo před ním je horní surogát (high surrogate), metoda tento pár spojí a vrátí odpovídající kódový bod. Jinak vrátí hodnotu jediné jednotky char bezprostředně před indexem, i když jde o surogát. Index uvnitř páru se automaticky neopravuje.

Mimo tento rozsah metoda vyvolá IndexOutOfBoundsException; prázdný řetězec nemá žádný platný index. V příkladu codePointBefore(3) vrátí 128512, zatímco codePointBefore(2) vrátí hodnotu horního surogátu 55357.

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.codePointBefore(3));
        System.out.println(text.codePointBefore(2));
        System.out.println(text.codePointBefore(1));
    }
}

Výsledek

4
128512
55357
65

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