Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

CKTIS / Java

HashSet.contains(Object) — comprobar si un elemento está presente

`contains` comprueba si un `HashSet` guarda un elemento igual al argumento. Devuelve `true` o `false` sin modificar el conjunto.

Versión: Java SE 21

Sintaxis

public boolean contains(Object o)
boolean present = set.contains(candidate);

En Java SE 21, HashSet.contains(Object), de java.util.HashSet, devuelve true si el conjunto contiene un elemento e para el que Objects.equals(o, e) es verdadero. En caso contrario, devuelve false. Lo que importa es la igualdad, no que ambas referencias apunten al mismo objeto. El método no añade ni elimina elementos.

El parámetro o es de tipo Object, no E. Por eso se puede buscar un Integer en un HashSet<String>, aunque no se pueda insertar con add. En el ejemplo, la búsqueda devuelve false porque el Integer no es igual a ninguna de las cadenas almacenadas. HashSet admite null: contains(null) devuelve true solo si el conjunto contiene null.

La búsqueda usa una tabla hash y tarda un tiempo constante si los códigos hash distribuyen bien los elementos entre los cubos de la tabla. Si sobrescribes equals, sobrescribe también hashCode: los objetos iguales deben tener el mismo código hash, pero compartir un código no implica que sean iguales.

Mientras un objeto esté en el conjunto, no cambies los datos que afectan a equals o hashCode. Tras un cambio de ese tipo, contains podría no encontrar ni siquiera ese mismo objeto.

Ejemplos

import java.util.HashSet;

public class Main {
    public static void main(String[] args) {
        HashSet<String> words = new HashSet<>();
        words.add("java");

        System.out.println(words.contains(new String("java")));
        System.out.println(words.contains("JAVA"));
        System.out.println(words.contains(Integer.valueOf(42)));
        System.out.println(words.contains(null));

        words.add(null);
        System.out.println(words.contains(null));
    }
}

Resultado

true
false
false
false
true

`new String("java")` crea deliberadamente un objeto distinto con el mismo texto. La comparación de cadenas distingue mayúsculas y minúsculas, así que `"JAVA"` no coincide. La búsqueda de un `Integer` es válida, pero devuelve `false`. Buscar `null` devuelve `false` antes de `add(null)` y `true` después.

Lecciones relacionadas

  • Java · Lección 55 · Básico · Versión: 2

Fuentes