The returned set will throw an IllegalArgumentException
+ * on an attempt to insert an element outside its range.
+ *
+ * @param fromElement low endpoint (inclusive) of the returned set
+ * @param toElement high endpoint (exclusive) of the returned set
* @return a view of the portion of this set whose elements range from
- * fromElement, inclusive, to toElement,
- * exclusive.
+ * fromElement, inclusive, to toElement, exclusive
* @throws ClassCastException if fromElement and
- * toElement cannot be compared to one another using
- * this set's comparator (or, if the set has no comparator,
- * using natural ordering).
- * @throws IllegalArgumentException if fromElement is
- * greater than toElement.
+ * toElement cannot be compared to one another using this
+ * set's comparator (or, if the set has no comparator, using
+ * natural ordering). Implementations may, but are not required
+ * to, throw this exception if fromElement or
+ * toElement cannot be compared to elements currently in
+ * the set.
* @throws NullPointerException if fromElement or
- * toElement is null
- * and this set does not permit null elements
+ * toElement is null and this set does
+ * not permit null elements
+ * @throws IllegalArgumentException if fromElement is
+ * greater than toElement; or if this set itself
+ * has a restricted range, and fromElement or
+ * toElement lies outside the bounds of the range.
*/
NavigableSet The returned set will throw an IllegalArgumentException
+ * on an attempt to insert an element outside its range.
+ *
+ * @param toElement high endpoint (exclusive) of the returned set
* @return a view of the portion of this set whose elements are strictly
- * less than toElement.
+ * less than toElement
* @throws ClassCastException if toElement is not compatible
* with this set's comparator (or, if the set has no comparator,
- * if toElement does not implement Comparable).
- * @throws NullPointerException if toElement is null
- * and this set does not permit null elements
+ * if toElement does not implement {@link Comparable}).
+ * Implementations may, but are not required to, throw this
+ * exception if toElement cannot be compared to elements
+ * currently in the set.
+ * @throws NullPointerException if toElement is null and
+ * this set does not permit null elements
+ * @throws IllegalArgumentException if this set itself has a
+ * restricted range, and toElement lies outside the
+ * bounds of the range
*/
NavigableSet The returned set will throw an IllegalArgumentException
+ * on an attempt to insert an element outside its range.
+ *
+ * @param fromElement low endpoint (inclusive) of the returned set
+ * @return a view of the portion of this set whose elements are greater
+ * than or equal to fromElement
+ * @throws ClassCastException if fromElement is not compatible
+ * with this set's comparator (or, if the set has no comparator,
+ * if fromElement does not implement {@link Comparable}).
+ * Implementations may, but are not required to, throw this
+ * exception if fromElement cannot be compared to elements
+ * currently in the set.
+ * @throws NullPointerException if fromElement is null
+ * and this set does not permit null elements
+ * @throws IllegalArgumentException if this set itself has a
+ * restricted range, and fromElement lies outside the
+ * bounds of the range
*/
NavigableSet