CKTIS / Java
String.charAt — čitanje UTF-16 kodne jedinice
String.charAt(int index) vraća char na indeksu koji počinje od nule. Čita UTF-16 kodnu jedinicu, a ne nužno cijeli Unicode znak.
Verzija: Java SE 21; repository runtime, production runtime not attested
Sintaksa
public char charAt(int index)String.charAt(int index) vraća char, odnosno UTF-16 kodnu jedinicu. Valjan indeks zadovoljava uvjet 0 <= index && index < text.length(). Prva jedinica ima indeks 0.
Negativan indeks ili indeks jednak length() ili veći od njega uzrokuje IndexOutOfBoundsException. Prazan niz nema valjan indeks.
Znak izvan BMP-a zauzima par surogata. charAt vraća samo jednu jedinicu tog para. U primjeru je text.charAt(1) visoki surogat; text.codePointAt(1) čita cijelu kodnu točku. Obje metode upotrebljavaju indekse UTF-16 kodnih jedinica.
Primjeri
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
Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.