TreeSet is one of the most important implementations of the SortedSet interface in Java that uses a Tree for storage. The ordering of the elements is maintained by a set using their natural ordering whether or not an explicit comparator is provided. This must be consistent with equals if it is to correctly implement the Set interface. It can also be ordered by a Comparator provided at set creation time, depending on which constructor is used. The TreeSet implements a NavigableSet interface by inheriting AbstractSet class.
Few important features of TreeSet are as follows:
- TreeSet implements the SortedSet interface so duplicate values are not allowed.
- Objects in a TreeSet are stored in a sorted and ascending order.
- TreeSet does not preserve the insertion order of elements but elements are sorted by keys.
- TreeSet does not allow to insert Heterogeneous objects. It will throw classCastException at Runtime if trying to add hetrogeneous objects.
- TreeSet serves as an excellent choice for storing large amounts of sorted information which are supposed to be accessed quickly because of its faster access and retrieval time.
- TreeSet is basically implementation of a self-balancing binary search tree like Red-Black Tree. Therefore operations like add, remove and search take O(Log n) time. And operations like printing n elements in sorted order takes O(n) time.
Constructors of TreeSet class:
- TreeSet t = new TreeSet();
This will create empty TreeSet object in which elements will get stored in default natural sorting order.
- TreeSet t = new TreeSet(Comparator comp);
This constructor is used when external specification of sorting order of elements is needed.
- TreeSet t = new TreeSet(Collection col);
This constructor is used when any conversion is needed from any Collection object to TreeSet object.
- TreeSet t = new TreeSet(SortedSet s);
This constructor is used to convert SortedSet object to TreeSet Object.
The implementation in a TreeSet is not synchronized in a sense that if multiple threads access a tree set concurrently, and at least one of the threads modifies the set, it must be synchronized externally. This is typically accomplished by synchronizing on some object that naturally encapsulates the set. If no such object exists, the set should be “wrapped” using the Collections.synchronizedSortedSet method. This is best done at creation time, to prevent accidental unsynchronized access to the set:
TreeSet ts = new TreeSet(); Set syncSet = Collections.synchronziedSet(ts);
Below program illustrates the basic opearation of a TreeSet:
[A, B, C]
Two things must be kept in mind while creating and adding elements into a TreeSet:
- Firstly, insertion of null into a TreeSet throws NullPointerException because while insertion of null, it gets compared to the existing elements and null cannot be compared to any value.
- Secondly, if we are depending on default natural sorting order, compulsory the object should be homogeneous and comparable otherwise we will get RuntimeException:ClassCastException
// Java code to illustrate StringBuffer
// class does not implements
// Comparable interface.
TreeSet<StringBuffer> ts =
// Elements are added using add() method
// We will get RunTimeException :ClassCastException
// As StringBuffer does not implements Comparable interface
- An object is said to be comparable if and only if the corresponding class implements Comparable interface.
- String class and all Wrapper classes already implements Comparable interface but StringBuffer class doesn’t implements Comparable interface.Hence we got ClassCastException in the above example.
- For an empty tree-set, when trying to insert null as first value, one will get NPE from JDK 7.From 1.7 onwards null is not at all accepted by TreeSet. However upto JDK 6, null will be accepted as first value, but any if insertion of any more values in the TreeSet, will also throw NullPointerException.
Hence it was considered as bug and thus removed in JDK 7.
- void add(Object o): This method will add specified element according to some sorting order in TreeSet. Duplicate entires will not get added.
- boolean addAll(Collection c): This method will add all elements of specified Collection to the set. Elements in Collection should be homogeneous otherwise ClassCastException will be thrown. Duplicate Entries of Collection will not be added to TreeSet.
- void clear(): This method will remove all the elements.
- boolean contains(Object o): This method will return true if given element is present in TreeSet else it will return false.
- Object first(): This method will return first element in TreeSet if TreeSet is not null else it will throw NoSuchElementException.
- Object last(): This method will return last element in TreeSet if TreeSet is not null else it will throw NoSuchElementException.
- SortedSet headSet(Object toElement): This method will return elements of TreeSet which are less than the specified element.
- SortedSet tailSet(Object fromElement): This method will return elements of TreeSet which are greater than or equal to the specified element.
- SortedSet subSet(Object fromElement, Object toElement): This method will return elements ranging from fromElement to toElement. fromElement is inclusive and toElement is exclusive.
- boolean isEmpty(): This method is used to return true if this set contains no elements or is empty and false for the opposite case.
- Object clone(): The method is used to return a shallow copy of the set, which is just a simple copied set.
- int size(): This method is used to return the size of the set or the number of elements present in the set.
- boolean remove(Object o): This method is used to return a specific element from the set.
- Iterator iterator(): Returns an iterator for iterating over the elements of the set.
- Comparator comparator(): This method will return Comparator used to sort elements in TreeSet or it will return null if default natural sorting order is used.
- ceiling(E e): This method returns the least element in this set greater than or equal to the given element, or null if there is no such element.
- descendingIterator(): This method returns an iterator over the elements in this set in descending order.
- descendingSet(): This method returns a reverse order view of the elements contained in this set.
- floor(E e): This method returns the greatest element in this set less than or equal to the given element, or null if there is no such element.
- higher(E e): This method returns the least element in this set strictly greater than the given element, or null if there is no such element.
- lower(E e): This method returns the greatest element in this set strictly less than the given element, or null if there is no such element.
- pollFirst(): This method retrieves and removes the first (lowest) element, or returns null if this set is empty.
- pollLast(): This method retrieves and removes the last (highest) element, or returns null if this set is empty.
- spliterator(): This method creates a late-binding and fail-fast Spliterator over the elements in this set.
- TreeSet in Java
- HashSet vs TreeSet in Java
- TreeSet last() Method in Java
- TreeSet first() Method in Java
- TreeSet add() Method in Java
- TreeSet contains() Method in Java
- How to loop over TreeSet in Java
- TreeSet remove() Method in Java
- TreeSet iterator() Method in Java
- TreeSet size() Method in Java
- TreeSet equals() method in Java with Example
- TreeSet comparator() Method in Java
- Convert HashSet to TreeSet in Java
- TreeSet pollLast() method in Java with Example
- TreeSet toString() method in Java with Example
This article is contributed by Dharmesh Singh. If you like GeeksforGeeks and would like to contribute, you can also write an article using contribute.geeksforgeeks.org or mail your article to email@example.com. See your article appearing on the GeeksforGeeks main page and help other Geeks.
Please write comments if you find anything incorrect, or you want to share more information about the topic discussed above.