Java HashSet Class

Introduction

The Java HashSet class implements the Set interface, backed by a hash table.Following are the important points about HashSet −

  • This class makes no guarantees as to the iteration order of the set; in particular, it does not guarantee that the order will remain constant over time.

  • This class permits the null element.

Class declaration

Following is the declaration for java.util.HashSet class −

public class HashSet<E>
   extends AbstractSet<E>
   implements Set<E>, Cloneable, Serializable

Parameters

Following is the parameter for java.util.HashSet class −

E − This is the type of elements maintained by this set.

Class constructors

Sr.No. Constructor & Description
1

HashSet()

This constructs a new, empty set; the backing HashMap instance has default initial capacity (16) and load factor (0.75).
2

HashSet(Collection<? extends E> c)

This constructs a new set containing the elements in the specified collection.
3

HashSet(int initialCapacity)

This constructs a new, empty set; the backing HashMap instance has the specified initial capacity and default load factor (0.75).
4

HashSet(int initialCapacity, float loadFactor)

This constructs a new, empty set; the backing HashMap instance has the specified initial capacity and the specified load factor.

Class methods

Sr.No. Method & Description
1 boolean add(E e)

This method adds the specified element to this set if it is not already present.
2 void clear()

This method removes all of the elements from this set.
3 Object clone()

This method returns a shallow copy of this HashSet instance, the elements themselves are not cloned.
4 boolean contains(Object o)

This method returns true if this set contains the specified element.
5 boolean isEmpty()

This method returns true if this set contains no elements.
6 Iterator<E> iterator()

This method returns an iterator over the elements in this set.
7 boolean remove(Object o)

This method removes the specified element from this set if it is present.
8 int size()

This method returns returns the number of elements in this set(its cardinality).
9 Spliterator<E> spliterator()

This method returns a late-binding and fail-fast Spliterator over the elements in this set.

Methods inherited

This class inherits methods from the following classes −

  • java.util.AbstractSet
  • java.util.AbstractCollection
  • java.util.Object
  • java.util.Set

Adding element to a HashSet Example

The following example shows the usage of Java HashSet add() method to add entries to the HashSet. We've created a HashSet object of Integer. Then few entries are added using add() method and then set is printed.

package com.tutorialspoint;

import java.util.HashSet;

public class HashSetDemo {
   public static void main(String args[]) {
      
      // create hash set
      HashSet <Integer> newset = new HashSet <>();

      // populate hash set
      newset.add(1); 
      newset.add(2);
      newset.add(3);  

      // checking elements in hash set
      System.out.println("Hash set values: "+ newset);
   }    
}

Output

Let us compile and run the above program, this will produce the following result.

Hash set values: [1, 2, 3]
Advertisements