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.