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.