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

CKTIS / Java

String.hashCode — código hash de uma cadeia de caracteres

String.hashCode devolve um código hash do tipo int calculado a partir do conteúdo de uma cadeia de caracteres. Cadeias iguais têm hashes iguais, mas hashes coincidentes não provam que as cadeias sejam iguais.

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

Sintaxe

public int hashCode()
int hash = text.hashCode();

String.hashCode é um método de instância sem argumentos que devolve um int. Processa unidades de código UTF-16 (char), não bytes nem pontos de código Unicode completos.

O cálculo pode ser expresso assim: começa com h = 0 e, em seguida, para cada unidade de código s.charAt(i), executa h = 31 * h + s.charAt(i). É usada aritmética int, incluindo em caso de overflow; o resultado pode ser negativo. Uma cadeia vazia produz 0.

As cadeias iguais segundo equals têm hashes idênticos. O inverso não se verifica: "Aa" e "BB" produzem ambas 2112, mas não são iguais. Isto é uma colisão. Para testar a igualdade, usa equals, não compares os hashes; um hash não é um identificador único.

Exemplos

public class Main {
    public static void main(String[] args) {
        System.out.println("".hashCode());
        System.out.println("abc".hashCode());
        System.out.println("Aa".hashCode());
        System.out.println("BB".hashCode());
        System.out.println("Aa".equals("BB"));
    }
}

Resultado

0
96354
2112
2112
false

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