CKTIS / Java
String.codePointBefore — codepoint vóór een index
String.codePointBefore retourneert de Unicode-waarde vóór een index van UTF-16-code-eenheden en houdt daarbij rekening met surrogaatparen.
Versie: Java SE 21; repository runtime, production runtime not attested
Syntax
public int codePointBefore(int index)String.codePointBefore(int index) retourneert een int die het codepoint vóór index voorstelt. De index telt UTF-16-code-eenheden (char), geen codepoints; het geldige bereik is 1 <= index && index <= length().
Een low surrogate direct vóór de index wordt gecombineerd met een voorafgaande high surrogate. Anders retourneert de methode de waarde van de afzonderlijke char, ook als dit een surrogate is. Een index binnen een paar wordt niet automatisch gecorrigeerd.
Buiten dit bereik wordt IndexOutOfBoundsException gegenereerd; een lege string heeft geen geldige index. In het voorbeeld retourneert codePointBefore(3) 128512, terwijl codePointBefore(2) de high surrogate 55357 retourneert.
Voorbeelden
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));
}
}Resultaat
4 128512 55357 65
De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.