Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / Java

String.codePoints — proud bodů kódu Unicode

String.codePoints() vrací IntStream a spojuje páry UTF-16 náhradních znaků, místo aby každou jednotku char zpracovávala samostatně.

Verze: Java SE 21; repository runtime, production runtime not attested

Syntaxe

public IntStream codePoints()
// Usage: text.codePoints()

String.codePoints() vrací IntStream hodnot bodů kódu. Platné páry náhradních znaků spojuje do jediné hodnoty int.

Ostatní jednotky UTF-16, včetně nespárovaných náhradních znaků, předává jako nezáporné hodnoty int. Chybně utvořené sekvence náhradních znaků tedy neodmítá.

length() počítá jednotky UTF-16, zatímco chars() je předává samostatně. V příkladu dvojice \uD83D\uDE00 vytvoří hodnotu 128512: ze čtyř jednotek vzniknou tři prvky proudu. Počet bodů kódu nemusí odpovídat počtu znaků, které vnímají uživatelé.

Příklady

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()));
    }
}

Výsledek

4
[65, 128512, 66]

Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.

Zdroje