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

CKTIS / Java

Character.isLetter(int) — verificar se um ponto de código é uma letra

Verifica se um ponto de código Unicode é uma letra, mesmo quando a sua representação em UTF-16 ocupa duas unidades de código `char`.

Versão: Java SE 21

Sintaxe

public static boolean isLetter(int codePoint)

boolean letter = Character.isLetter(codePoint);

Character.isLetter(int) é um método estático de java.lang.Character. Recebe um ponto de código Unicode como int e devolve true apenas para as categorias de letra maiúscula (Lu), minúscula (Ll), de título (Lt), modificadora (Lm) ou outra letra (Lo). O Java SE 21 usa Unicode 15.0 para esta classificação, independentemente das definições regionais.

A sobrecarga Character.isLetter(char) testa uma única unidade de código UTF-16 de 16 bits. Um ponto de código acima de U+FFFF ocupa duas unidades, que formam um par de substituição. Ao percorrer uma String, usa codePoints() para juntar cada par válido num único int; charAt(int) devolve apenas uma unidade.

O método não testa uma cadeia inteira nem um carácter tal como é percebido por quem lê, que pode ser composto por vários pontos de código. Por exemplo, é (U+00E9) é uma letra, mas o acento agudo combinante (U+0301) que pode seguir e não é, por si só, uma letra.

Exemplos

public class Main {
    public static void main(String[] args) {
        String text = "A7\u0301\uD840\uDC00";
        text.codePoints().forEachOrdered(cp ->
            System.out.println(Character.isLetter(cp))
        );
        System.out.println("charAt(3): " + Character.isLetter(text.charAt(3)));
    }
}

Resultado

true
false
false
true
charAt(3): false

Os primeiros quatro resultados correspondem, por ordem, a `A`, ao algarismo `7`, ao acento agudo combinante U+0301 e ao ideograma U+20000. O último resultado é `false` porque `charAt(3)` devolve apenas a primeira unidade do par de substituição do ideograma e é chamada a sobrecarga `char`.

Lições relacionadas

  • Java · Lição 63 · Básico · Versão: 2

Fontes