CKTIS / Java
String.charAt — branje kodne enote UTF-16
String.charAt(int index) vrne char na indeksu, ki se začne z ničlo. Bere kodno enoto UTF-16, ne nujno celotnega znaka Unicode.
Različica: Java SE 21; repository runtime, production runtime not attested
Sintaksa
public char charAt(int index)String.charAt(int index) vrne char, torej kodno enoto UTF-16. Veljaven indeks izpolnjuje pogoj 0 <= index && index < text.length(). Prva enota ima indeks 0.
Negativen indeks ali indeks, ki je enak length() ali večji od njega, povzroči IndexOutOfBoundsException. Prazen niz nima veljavnega indeksa.
Znak zunaj BMP zaseda par nadomestnih enot. charAt vrne samo eno enoto tega para. V primeru je text.charAt(1) višja nadomestna enota; text.codePointAt(1) prebere celotno kodno točko. Obe metodi uporabljata indekse kodnih enot UTF-16.
Primeri
public class Main {
public static void main(String[] args) {
String text = "A\uD83D\uDE00B";
System.out.println(text.charAt(0));
System.out.println(text.length());
System.out.println((int) text.charAt(1));
System.out.println(text.codePointAt(1));
}
}Rezultat
A 4 55357 128512
Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.