Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

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.

Źródła