Spliterator documentation on Priority(Blocking)Queue

Paul Sandoz paul.sandoz at oracle.com
Tue Aug 4 07:56:38 UTC 2015

Hi Tagir,

Can you log an issue?


On 4 Aug 2015, at 06:47, Tagir Valeev <amaembo at gmail.com> wrote:

> Hello!
> The PriorityQueue class iterator() returns elements in no particular order.
> This is explicitly stated in JavaDoc for iterator() method [1] as well as
> in class description [2]. However it's not mentioned mentioned that
> spliterator() method also traverses the queue in no particular order. Well,
> the user might guess that the order is not specified, because the
> spliterator does not have ORDERED characteristic, but it's not so obvious
> for any user. Probably it's would be good to add an explicit note like it's
> done for iterator. The same thing is for PriorityBlockingQueue. What do you
> think?
> With best regards,
> Tagir Valeev.
> [1]
> http://hg.openjdk.java.net/jdk9/dev/jdk/file/022d45d94d0a/src/java.base/share/classes/java/util/PriorityQueue.java#l477
> [2]
> http://hg.openjdk.java.net/jdk9/dev/jdk/file/022d45d94d0a/src/java.base/share/classes/java/util/PriorityQueue.java#l54

More information about the core-libs-dev mailing list