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

CKTIS / Java

String.charAt — leitura de uma unidade de código UTF-16

String.charAt(int index) devolve o char no índice baseado em zero. Lê uma unidade de código UTF-16, não necessariamente um carácter Unicode completo.

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

Sintaxe

public char charAt(int index)

String.charAt(int index) devolve um char, ou seja, uma unidade de código UTF-16. Um índice válido satisfaz 0 <= index && index < text.length(). A primeira unidade tem o índice 0.

Um índice negativo ou igual ou superior a length() provoca IndexOutOfBoundsException. Uma cadeia vazia não tem qualquer índice válido.

Um carácter fora do BMP ocupa um par de substitutos. charAt devolve apenas uma unidade desse par. No exemplo, text.charAt(1) é o substituto alto; text.codePointAt(1) lê o ponto de código completo. Ambos os métodos utilizam índices de unidades de código UTF-16.

Exemplos

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

Resultado

A
4
55357
128512

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