Returns a view of the portion of this map whose keys range from
{@code fromKey} to {@code toKey}. If {@code fromKey} and
{@code toKey} are equal, the returned map is empty unless
{@code fromInclusive} and {@code toInclusive} are both true. The
returned map is backed by this map, so changes in the returned map are
reflected in this map, and vice-versa. The returned map supports all
optional map operations that this map supports.
<p>The returned map will throw an {@code IllegalArgumentException}
on an attempt to insert a key outside of its range, or to construct a
submap either of whose endpoints lie outside its range.
@param fromKey low endpoint of the keys in the returned map
@param fromInclusive {@code true} if the low endpoint
is to be included in the returned view
@param toKey high endpoint of the keys in the returned map
@param toInclusive {@code true} if the high endpoint
is to be included in the returned view
@return a view of the portion of this map whose keys range from
{@code fromKey} to {@code toKey}
@throws ClassCastException if {@code fromKey} and {@code toKey}
cannot be compared to one another using this map's comparator
(or, if the map has no comparator, using natural ordering).
Implementations may, but are not required to, throw this
exception if {@code fromKey} or {@code toKey}
cannot be compared to keys currently in the map.
@throws NullPointerException if {@code fromKey} or {@code toKey}
is null and this map does not permit null keys
@throws IllegalArgumentException if {@code fromKey} is greater than
{@code toKey}; or if this map itself has a restricted
range, and {@code fromKey} or {@code toKey} lies
outside the bounds of the range
NavigableMap!(K, V)subMap(K fromKey, bool fromInclusive, K toKey, bool toInclusive)
Returns a view of the portion of this map whose keys range from {@code fromKey} to {@code toKey}. If {@code fromKey} and {@code toKey} are equal, the returned map is empty unless {@code fromInclusive} and {@code toInclusive} are both true. The returned map is backed by this map, so changes in the returned map are reflected in this map, and vice-versa. The returned map supports all optional map operations that this map supports.
<p>The returned map will throw an {@code IllegalArgumentException} on an attempt to insert a key outside of its range, or to construct a submap either of whose endpoints lie outside its range.
@param fromKey low endpoint of the keys in the returned map @param fromInclusive {@code true} if the low endpoint is to be included in the returned view @param toKey high endpoint of the keys in the returned map @param toInclusive {@code true} if the high endpoint is to be included in the returned view @return a view of the portion of this map whose keys range from {@code fromKey} to {@code toKey} @throws ClassCastException if {@code fromKey} and {@code toKey} cannot be compared to one another using this map's comparator (or, if the map has no comparator, using natural ordering). Implementations may, but are not required to, throw this exception if {@code fromKey} or {@code toKey} cannot be compared to keys currently in the map. @throws NullPointerException if {@code fromKey} or {@code toKey} is null and this map does not permit null keys @throws IllegalArgumentException if {@code fromKey} is greater than {@code toKey}; or if this map itself has a restricted range, and {@code fromKey} or {@code toKey} lies outside the bounds of the range