CKTIS / Java
String.codePointBefore — punkt kodowy przed indeksem
String.codePointBefore zwraca wartość Unicode przed indeksem jednostek UTF-16, uwzględniając pary surogatów.
Wersja: Java SE 21; repository runtime, production runtime not attested
Składnia
public int codePointBefore(int index)String.codePointBefore(int index) zwraca int opisujący punkt kodowy przed index. Indeks liczy jednostki UTF-16 (char), nie punkty kodowe; poprawny zakres to 1 <= index && index <= length().
Jeśli przed indeksem znajduje się dolny surogat poprzedzony górnym, metoda łączy parę. W przeciwnym razie zwraca wartość pojedynczego char, także surogatu. Indeks wewnątrz pary nie jest automatycznie poprawiany.
Poza zakresem metoda zgłasza IndexOutOfBoundsException; pusty napis nie ma poprawnego indeksu. W przykładzie codePointBefore(3) zwraca 128512, natomiast codePointBefore(2) zwraca górny surogat 55357.
Przykłady
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));
}
}Wynik
4 128512 55357 65
Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.