CKTIS / Java
HashSet.contains(Object) — controleren of een element aanwezig is
`contains` controleert of een `HashSet` een element bevat dat gelijk is aan het argument. De methode geeft `true` of `false` terug zonder de verzameling te wijzigen.
Versie: Java SE 21
Syntax
public boolean contains(Object o)
boolean present = set.contains(candidate);In Java SE 21 geeft HashSet.contains(Object) uit java.util.HashSet de waarde true terug als de verzameling een element e bevat waarvoor Objects.equals(o, e) waar is. Anders geeft de methode false terug. Het gaat om gelijkheid, niet om de vraag of beide referenties naar hetzelfde object wijzen. De methode voegt niets toe en verwijdert niets.
De parameter o heeft het type Object, niet E. Je kunt dus in een HashSet<String> naar een Integer zoeken, ook al kun je die niet met add toevoegen. In het voorbeeld levert die zoekopdracht false op, omdat de Integer niet gelijk is aan een van de opgeslagen tekenreeksen. HashSet staat null toe: contains(null) geeft alleen true terug als de verzameling null bevat.
De zoekopdracht gebruikt een hashtabel en duurt constante tijd als hashcodes de elementen goed over de buckets verdelen. Als je equals overschrijft, overschrijf dan ook hashCode: gelijke objecten moeten dezelfde hashcode hebben, maar dezelfde hashcode betekent niet dat objecten gelijk zijn.
Wijzig geen gegevens die equals of hashCode beïnvloeden zolang een object in de verzameling zit. Na zo’n wijziging kan contains zelfs datzelfde object mogelijk niet meer vinden.
Voorbeelden
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));
}
}Resultaat
true false false false true
`new String("java")` maakt bewust een apart object met dezelfde tekst. Het vergelijken van tekenreeksen is hoofdlettergevoelig, dus `"JAVA"` komt niet overeen. Zoeken naar een `Integer` is geldig, maar levert `false` op. Zoeken naar `null` levert vóór `add(null)` `false` op en erna `true`.
Gerelateerde lessen
- Java · Les 55 · Basis · Versie: 2