/************************************************************************* * Compilation: javac SET.java * Execution: java SET * * Set implementation using Java's TreeSet library. * Does not allow duplicates. * * % java SET * 128.112.136.11 * 208.216.181.15 * null * *************************************************************************/ import java.util.Iterator; import java.util.NoSuchElementException; import java.util.TreeSet; import edu.princeton.cs.introcs.StdOut; /** * The SET class represents an ordered set of comparable keys. * It supports the usual add , contains , and delete * methods. It also provides ordered methods for finding the minimum , * maximum , floor , and ceiling and set methods * for union , intersection , and equality . * * This implementation uses a balanced binary search tree. It requires that * the key type implements the Comparable interface and calls the * compareTo() and method to compare two keys. It does not call either * equals() or hashCode() . * The add , contains , delete , minimum , * maximum , ceiling , and floor methods take * logarithmic time in the worst case. * The size , and is-empty operations take constant time. * Construction takes constant time. * * For additional documentation, see * Section 3.5 of * Algorithms in Java, 4th Edition by Robert Sedgewick and Kevin Wayne. * * @author Robert Sedgewick * @author Kevin Wayne */ public class SET> implements Iterable { private TreeSet set; /** * Initializes an empty set. */ public SET() { set = new TreeSet(); } /** * Adds the key to the set if it is not already present. * @param key the key to add * @throws NullPointerException if key is null */ public void add(Key key) { if (key == null) throw new NullPointerException("called add() with a null key"); set.add(key); } /** * Does the set contain the given key? * @param key the key * @return true if the set contains key and * false otherwise * @throws NullPointerException if key is null */ public boolean contains(Key key) { if (key == null) throw new NullPointerException("called contains() with a null key"); return set.contains(key); } /** * Removes the key from the set if the key is present. * @param key the key * @throws NullPointerException if key is null */ public void delete(Key key) { if (key == null) throw new NullPointerException("called delete() with a null key"); set.remove(key); } /** * Returns the number of keys in the set. * @return the number of keys in the set */ public int size() { return set.size(); } /** * Is the set empty? * @return true if the set is empty, and false otherwise */ public boolean isEmpty() { return size() == 0; } /** * Returns all of the keys in the set, as an iterator. * To iterate over all of the keys in a set named set , use the * foreach notation: for (Key key : set) . * @return an iterator to all of the keys in the set */ public Iterator iterator() { return set.iterator(); } /** * Returns the largest key in the set. * @return the largest key in the set * @throws NoSuchElementException if the set is empty */ public Key max() { if (isEmpty()) throw new NoSuchElementException("called max() with empty set"); return set.last(); } /** * Returns the smallest key in the set. * @return the smallest key in the set * @throws NoSuchElementException if the set is empty */ public Key min() { if (isEmpty()) throw new NoSuchElementException("called min() with empty set"); return set.first(); } /** * Returns the smallest key in the set greater than or equal to key . * @return the smallest key in the set greater than or equal to key * @param key the key * @throws NoSuchElementException if there is no such key * @throws NullPointerException if key is null */ public Key ceiling(Key key) { if (key == null) throw new NullPointerException("called ceiling() with a null key"); Key k = set.ceiling(key); if (k == null) throw new NoSuchElementException("all keys are less than " + key); return k; } /** * Returns the largest key in the set less than or equal to key . * @return the largest key in the set table less than or equal to key * @param key the key * @throws NoSuchElementException if there is no such key * @throws NullPointerException if key is null */ public Key floor(Key key) { if (key == null) throw new NullPointerException("called floor() with a null key"); Key k = set.floor(key); if (k == null) throw new NoSuchElementException("all keys are greater than " + key); return k; } /** * Returns the union of this set and that set. * @param that the other set * @return the union of this set and that set * @throws NullPointerException if that is null */ public SET union(SET that) { if (that == null) throw new NullPointerException("called union() with a null argument"); SET c = new SET(); for (Key x : this) { c.add(x); } for (Key x : that) { c.add(x); } return c; } /** * Returns the intersection of this set and that set. * @param that the other set * @return the intersection of this set and that set * @throws NullPointerException if that is null */ public SET intersects(SET that) { if (that == null) throw new NullPointerException("called intersects() with a null argument"); SET c = new SET(); if (this.size() < that.size()) { for (Key x : this) { if (that.contains(x)) c.add(x); } } else { for (Key x : that) { if (this.contains(x)) c.add(x); } } return c; } /** * Does this set equal y ? * Note that this method declares two empty sets to be equal * even if they are parameterized by different generic types. * This is consistent with the behavior of equals() * within Java's Collections framework. * @param y the other set * @return true if the two sets are equal; false otherwise */ @Override public boolean equals(Object y) { if (y == this) return true; if (y == null) return false; if (y.getClass() != this.getClass()) return false; SET that = (SET) y; if (this.size() != that.size()) return false; try { for (Key k : this) if (!that.contains(k)) return false; } catch (ClassCastException exception) { return false; } return true; } /** * Returns a string representation of this set. * @return a string representation of this set, with the keys separated * by single spaces */ @Override public String toString() { StringBuilder s = new StringBuilder(); for (Key key : this) s.append(key + " "); return s.toString(); } /** * Unit tests the SET data type. */ public static void main(String[] args) { SET set = new SET(); // insert some keys set.add("www.cs.princeton.edu"); set.add("www.cs.princeton.edu"); // overwrite old value set.add("www.princeton.edu"); set.add("www.math.princeton.edu"); set.add("www.yale.edu"); set.add("www.amazon.com"); set.add("www.simpsons.com"); set.add("www.stanford.edu"); set.add("www.google.com"); set.add("www.ibm.com"); set.add("www.apple.com"); set.add("www.slashdot.com"); set.add("www.whitehouse.gov"); set.add("www.espn.com"); set.add("www.snopes.com"); set.add("www.movies.com"); set.add("www.cnn.com"); set.add("www.iitb.ac.in"); StdOut.println(set.contains("www.cs.princeton.edu")); StdOut.println(!set.contains("www.harvardsucks.com")); StdOut.println(set.contains("www.simpsons.com")); StdOut.println(); StdOut.println("ceiling(www.simpsonr.com) = " + set.ceiling("www.simpsonr.com")); StdOut.println("ceiling(www.simpsons.com) = " + set.ceiling("www.simpsons.com")); StdOut.println("ceiling(www.simpsont.com) = " + set.ceiling("www.simpsont.com")); StdOut.println("floor(www.simpsonr.com) = " + set.floor("www.simpsonr.com")); StdOut.println("floor(www.simpsons.com) = " + set.floor("www.simpsons.com")); StdOut.println("floor(www.simpsont.com) = " + set.floor("www.simpsont.com")); StdOut.println(); // print out all keys in the set in lexicographic order for (String s : set) { StdOut.println(s); } } }