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

CKTIS / Java

String.length — comprimento em unidades UTF-16

String.length() devolve o número de unidades de código UTF-16, que não corresponde necessariamente ao número de caracteres visíveis para o utilizador.

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

Sintaxe

public int length()
text.length()

String.length é um método de instância: a chamada text.length() não recebe argumentos e devolve um int. Uma cadeia vazia devolve 0.

O método conta unidades de código UTF-16, ou seja, valores char. Um carácter Unicode suplementar ocupa um par de substitutos, aumentando o resultado em 2. Não interprete este resultado como o número de caracteres visíveis para o utilizador.

Utilize text.codePointCount(0, text.length()) para contar pontos de código. No exemplo, A e o emoji produzem um comprimento de 3, mas correspondem a dois pontos de código.

Exemplos

public class Main {
    public static void main(String[] args) {
        String text = "A\uD83D\uDE00";
        System.out.println(text.length());
        System.out.println(text.codePointCount(0, text.length()));
        System.out.println("".length());
    }
}

Resultado

3
2
0

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