Package Summary Overview Summary

### method:add(E) [CHANGED]
### add public boolean add (E e) Inserts the specified element at the tail of this deque. As the deque is unbounded, this method will never throw `IllegalStateException` or return `false`. Specified by: `add` in interface `Collection<E>` Specified by: `add` in interface `Deque<E>` Specified by: `add` in interface `Queue<E>` Overrides: `add` in class `AbstractCollection<E>` Parameters: `e` - theelement whose presence in this collection is to addbe ensured Returns: `true` (as specified by `Collection.add(E)`) Throws: `NullPointerException` - if the specified element is null
### add public boolean add (E e) Inserts the specified element at the tail of this deque. As the deque is unbounded, this method will never throw `IllegalStateException` or return `false`. Specified by: `add` in interface `Collection<E>` Specified by: `add` in interface `Deque<E>` Specified by: `add` in interface `Queue<E>` Overrides: `add` in class `AbstractCollection<E>` Parameters: `e` - the element to add Returns: `true` (as specified by `Collection.add(E)`) Throws: `NullPointerException` - if the specified element is null | ### add public boolean add (E e) Inserts the specified element at the tail of this deque. As the deque is unbounded, this method will never throw `IllegalStateException` or return `false`. Specified by: `add` in interface `Collection<E>` Specified by: `add` in interface `Deque<E>` Specified by: `add` in interface `Queue<E>` Overrides: `add` in class `AbstractCollection<E>` Parameters: `e` - element whose presence in this collection is to be ensured Returns: `true` (as specified by `Collection.add(E)`) Throws: `NullPointerException` - if the specified element is null

### method:addAll(java.util.Collection) [CHANGED]
### addAll public boolean addAll (Collection<? extends E> c) Appends all of the elements in the specified collection to the end of this deque, in the order that they are returned by the specified collection's iterator. Attempts to `addAll` of a deque to itself result in `IllegalArgumentException`. Specified by: `addAll` in interface `Collection<E>` Specified by: `addAll` in interface `Deque<E>` Overrides: `addAll` in class `AbstractCollection<E>` Parameters: `c` - the elements to be inserted into this deque Returns: `true` if this deque changed as a result of the call Throws: `NullPointerException` - if the specified collection or any of its elements are null `IllegalArgumentException` - if the collection is this deque See Also: `CollectionAbstractCollection.add(Object)`
### addAll public boolean addAll (Collection<? extends E> c) Appends all of the elements in the specified collection to the end of this deque, in the order that they are returned by the specified collection's iterator. Attempts to `addAll` of a deque to itself result in `IllegalArgumentException`. Specified by: `addAll` in interface `Collection<E>` Specified by: `addAll` in interface `Deque<E>` Overrides: `addAll` in class `AbstractCollection<E>` Parameters: `c` - the elements to be inserted into this deque Returns: `true` if this deque changed as a result of the call Throws: `NullPointerException` - if the specified collection or any of its elements are null `IllegalArgumentException` - if the collection is this deque See Also: `Collection.add(Object)` | ### addAll public boolean addAll (Collection<? extends E> c) Appends all of the elements in the specified collection to the end of this deque, in the order that they are returned by the specified collection's iterator. Attempts to `addAll` of a deque to itself result in `IllegalArgumentException`. Specified by: `addAll` in interface `Collection<E>` Specified by: `addAll` in interface `Deque<E>` Overrides: `addAll` in class `AbstractCollection<E>` Parameters: `c` - the elements to be inserted into this deque Returns: `true` if this deque changed as a result of the call Throws: `NullPointerException` - if the specified collection or any of its elements are null `IllegalArgumentException` - if the collection is this deque See Also: `AbstractCollection.add(Object)`

### method:removeAll(java.util.Collection) [CHANGED]
### removeAll public boolean removeAll (Collection<?> c) Description copied from interfaceclass: `CollectionAbstractCollection` Removes all of this collection's elements that are also contained in the specified collection (optional operation). After this call returns, this collection will contain no elements in common with the specified collection. Specified by: `removeAll` in interface `Collection<E>` Overrides: `removeAll` in class `AbstractCollection<E>` Parameters: `c` - collection containing elements to be removed from this collection Returns: `true` if this collection changed as a result of the call Throws: `NullPointerException` - if this collection contains one or more null elements and the specified collection does not support null elements (optional), or if the specified collection is null See Also: `CollectionAbstractCollection.remove(Object)` `CollectionAbstractCollection.contains(Object)`
### removeAll public boolean removeAll (Collection<?> c) Description copied from interface: `Collection` Removes all of this collection's elements that are also contained in the specified collection (optional operation). After this call returns, this collection will contain no elements in common with the specified collection. Specified by: `removeAll` in interface `Collection<E>` Overrides: `removeAll` in class `AbstractCollection<E>` Parameters: `c` - collection containing elements to be removed from this collection Returns: `true` if this collection changed as a result of the call Throws: `NullPointerException` - if this collection contains one or more null elements and the specified collection does not support null elements (optional), or if the specified collection is null See Also: `Collection.remove(Object)` `Collection.contains(Object)` | ### removeAll public boolean removeAll (Collection<?> c) Description copied from class: `AbstractCollection` Removes all of this collection's elements that are also contained in the specified collection (optional operation). After this call returns, this collection will contain no elements in common with the specified collection. Specified by: `removeAll` in interface `Collection<E>` Overrides: `removeAll` in class `AbstractCollection<E>` Parameters: `c` - collection containing elements to be removed from this collection Returns: `true` if this collection changed as a result of the call Throws: `NullPointerException` - if this collection contains one or more null elements and the specified collection does not support null elements (optional), or if the specified collection is null See Also: `AbstractCollection.remove(Object)` `AbstractCollection.contains(Object)`

### method:retainAll(java.util.Collection) [CHANGED]
### retainAll public boolean retainAll (Collection<?> c) Description copied from interfaceclass: `CollectionAbstractCollection` Retains only the elements in this collection that are contained in the specified collection (optional operation). In other words, removes from this collection all of its elements that are not contained in the specified collection. Specified by: `retainAll` in interface `Collection<E>` Overrides: `retainAll` in class `AbstractCollection<E>` Parameters: `c` - collection containing elements to be retained in this collection Returns: `true` if this collection changed as a result of the call Throws: `NullPointerException` - if this collection contains one or more null elements and the specified collection does not permit null elements (optional), or if the specified collection is null See Also: `CollectionAbstractCollection.remove(Object)` `CollectionAbstractCollection.contains(Object)`
### retainAll public boolean retainAll (Collection<?> c) Description copied from interface: `Collection` Retains only the elements in this collection that are contained in the specified collection (optional operation). In other words, removes from this collection all of its elements that are not contained in the specified collection. Specified by: `retainAll` in interface `Collection<E>` Overrides: `retainAll` in class `AbstractCollection<E>` Parameters: `c` - collection containing elements to be retained in this collection Returns: `true` if this collection changed as a result of the call Throws: `NullPointerException` - if this collection contains one or more null elements and the specified collection does not permit null elements (optional), or if the specified collection is null See Also: `Collection.remove(Object)` `Collection.contains(Object)` | ### retainAll public boolean retainAll (Collection<?> c) Description copied from class: `AbstractCollection` Retains only the elements in this collection that are contained in the specified collection (optional operation). In other words, removes from this collection all of its elements that are not contained in the specified collection. Specified by: `retainAll` in interface `Collection<E>` Overrides: `retainAll` in class `AbstractCollection<E>` Parameters: `c` - collection containing elements to be retained in this collection Returns: `true` if this collection changed as a result of the call Throws: `NullPointerException` - if this collection contains one or more null elements and the specified collection does not permit null elements (optional), or if the specified collection is null See Also: `AbstractCollection.remove(Object)` `AbstractCollection.contains(Object)`