--- jsr166/src/main/java/util/Deque.java 2005/07/18 19:14:17 1.15 +++ jsr166/src/main/java/util/Deque.java 2012/10/21 06:40:20 1.21 @@ -1,11 +1,10 @@ /* * Written by Doug Lea and Josh Bloch with assistance from members of * JCP JSR-166 Expert Group and released to the public domain, as explained - * at http://creativecommons.org/licenses/publicdomain + * at http://creativecommons.org/publicdomain/zero/1.0/ */ package java.util; -import java.util.*; // for javadoc (till 6280605 is fixed) /** * A linear collection that supports element insertion and removal at @@ -154,7 +153,7 @@ import java.util.*; // for javadoc (till * Object. * *

This interface is a member of the Java Collections + * href="{@docRoot}/../technotes/guides/collections/index.html"> Java Collections * Framework. * * @author Doug Lea @@ -162,7 +161,6 @@ import java.util.*; // for javadoc (till * @since 1.6 * @param the type of elements held in this collection */ - public interface Deque extends Queue { /** * Inserts the specified element at the front of this deque if it is @@ -276,7 +274,7 @@ public interface Deque extends Queue< /** * Retrieves, but does not remove, the first element of this deque. - * + * * This method differs from {@link #peekFirst peekFirst} only in that it * throws an exception if this deque is empty. * @@ -534,4 +532,15 @@ public interface Deque extends Queue< * @return an iterator over the elements in this deque in proper sequence */ Iterator iterator(); + + /** + * Returns an iterator over the elements in this deque in reverse + * sequential order. The elements will be returned in order from + * last (tail) to first (head). + * + * @return an iterator over the elements in this deque in reverse + * sequence + */ + Iterator descendingIterator(); + }