Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

CKTIS / Java

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

String.codePointAt vracia int predstavujúci kódový bod, ale prijíma index jednotky kódu UTF-16, nie poradové číslo kódového bodu.

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

Syntax

public int codePointAt(int index)

String.codePointAt(int index) číta hodnotu na indexe jednotky kódu UTF-16 (char). Výsledkom je int, na rozdiel od výsledku metódy charAt.

Ak je jednotka na zadanom indexe horný surogát a bezprostredne za ňou nasleduje dolný surogát, metóda spojí tieto dve jednotky do jedného kódového bodu. Inak vráti hodnotu jednotky char na zadanom indexe, a to aj v prípade nespárovaného surogátu. Ak index ukazuje na dolný surogát, metóda spätne nehľadá začiatok páru.

Musí platiť 0 <= index && index < text.length(). Pri porušení podmienky sa vyvolá IndexOutOfBoundsException; prázdny reťazec nemá žiadny platný index.

V príklade zaberá surogátový pár \uD83D\uDE00 dve pozície: na indexe 1 metóda vráti 128512, zatiaľ čo na indexe 2 vráti hodnotu dolného surogátu 56832.

Prí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ýsledok

4
65
128512
56832

Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.

Zdroje