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.