Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / Java

String.codePointBefore — ponto de código antes de um índice

String.codePointBefore devolve o valor Unicode anterior a um índice de unidade de código UTF-16, tendo em conta os pares de substitutos.

Versão: Java SE 21; repository runtime, production runtime not attested

Sintaxe

public int codePointBefore(int index)

String.codePointBefore(int index) devolve um int que representa o ponto de código anterior a index. O índice conta unidades de código UTF-16 (char), não pontos de código; o intervalo válido é 1 <= index && index <= length().

Um substituto baixo imediatamente antes do índice é combinado com um substituto alto anterior. Caso contrário, o método devolve o valor do char individual, mesmo que seja um substituto. Um índice dentro de um par não é corrigido automaticamente.

Fora deste intervalo, o método lança IndexOutOfBoundsException; uma cadeia vazia não tem nenhum índice válido. No exemplo, codePointBefore(3) devolve 128512, enquanto codePointBefore(2) devolve o substituto alto 55357.

Exemplos

public class Main {
    public static void main(String[] args) {
        String text = "A\uD83D\uDE00B";
        System.out.println(text.length());
        System.out.println(text.codePointBefore(3));
        System.out.println(text.codePointBefore(2));
        System.out.println(text.codePointBefore(1));
    }
}

Resultado

4
128512
55357
65

O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.

Fontes