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

CKTIS / Java

String.codePointAt — ponto de código num índice UTF-16

String.codePointAt devolve um int que representa um ponto de código, mas aceita um índice de unidade de código UTF-16, não a posição ordinal de um ponto de código.

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

Sintaxe

public int codePointAt(int index)

String.codePointAt(int index) lê o valor no índice de uma unidade de código UTF-16 (char). O resultado é um int, ao contrário do resultado de charAt.

Se a unidade selecionada for um substituto alto seguido de um substituto baixo, o método combina o par. Caso contrário, devolve o valor do char selecionado, incluindo quando se trata de um substituto sem par. Selecionar um substituto baixo não recua até ao início do par.

É necessário que se verifique 0 <= index && index < text.length(). Se a condição não for satisfeita, é lançada IndexOutOfBoundsException; uma cadeia vazia não tem índices válidos.

No exemplo, o par \uD83D\uDE00 ocupa dois índices: no índice 1 obtém-se 128512, enquanto no índice 2 se obtém o valor do substituto baixo 56832.

Exemplos

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

Resultado

4
65
128512
56832

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