CKTIS / Java
String.codePoints — strumień punktów kodowych Unicode
String.codePoints() zwraca IntStream, łącząc pary surogatów UTF-16 zamiast przetwarzać każdą jednostkę char osobno.
Wersja: Java SE 21; repository runtime, production runtime not attested
Składnia
public IntStream codePoints()
// Usage: text.codePoints()String.codePoints() zwraca IntStream wartości punktów kodowych. Łączy poprawne pary surogatów w jedną wartość int.
Pozostałe jednostki UTF-16, także niesparowane surogaty, przekazuje jako nieujemne wartości int. Nie odrzuca więc niepoprawnych sekwencji surogatów.
length() liczy jednostki UTF-16, a chars() przekazuje je oddzielnie. W przykładzie para \uD83D\uDE00 daje wartość 128512: cztery jednostki tworzą trzy elementy strumienia. Liczba punktów kodowych nie musi odpowiadać liczbie znaków postrzeganych przez użytkownika.
Przykłady
import java.util.Arrays;
public class Main {
public static void main(String[] args) {
String text = "A\uD83D\uDE00B";
System.out.println(text.length());
System.out.println(Arrays.toString(text.codePoints().toArray()));
}
}Wynik
4 [65, 128512, 66]
Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.