RFR 8014824: Document Spliterator characteristics and binding policy of java util collection impls

Paul Sandoz paul.sandoz at oracle.com
Thu Aug 8 09:00:19 UTC 2013


The following patch updates documentation for various spliterators:


Mostly this is just clarifying stuff that was missing, but there are a few cases of a spec change to Collections (CCC will be created):


This is for the Collection.empty/singleton/nCopies relaxing the reporting of characteristics for spliterators containing 0 or 1 elements. It's more efficient to share code for empty and singleton spliterator implementations (and instance for the former) rather than attempting to conform the required characteristics of the collection, which will anyway have little or no benefit in terms of the client trying to optimize based on those characteristics.


More information about the core-libs-dev mailing list