Script: Class dw.util.SortedMap

Class SortedMap

A map that further guarantees that it will be in ascending key order, sorted according to the natural ordering of its keys, or by a comparator provided at sorted map creation time. This order is reflected when iterating over the sorted map's collection views (returned by the entrySet, keySet and values methods). Note that sorting by natural order is only supported for Number, String, Date, Money and Quantity as key.

Constructor Summary

SortedMap()

Constructor to create a new SortedMap.

SortedMap(comparator : Object)

Constructor to create a new SortedMap.

Method Summary

clone() : SortedMap

Returns a shallow copy of this map.

firstKey() : Object

Returns the first (lowest) key currently in this sorted map.

headMap(key : Object) : SortedMap

Returns a view of the portion of this map whose keys are strictly less than toKey.

lastKey() : Object

Returns the last (highest) key currently in this sorted map.

subMap(from : Object, to : Object) : SortedMap

Returns a view of the portion of this map whose keys range from fromKey, inclusive, to toKey, exclusive.

tailMap(key : Object) : SortedMap

Returns a view of the portion of this map whose keys are greater than or equal to fromKey.

Methods inherited from class Map

clear, containsKey, containsValue, entrySet, get, getLength, isEmpty, keySet, put, putAll, remove, size, values, values

Methods inherited from class Object

assign, create, create, defineProperties, defineProperty, entries, freeze, fromEntries, getOwnPropertyDescriptor, getOwnPropertyNames, getOwnPropertySymbols, getPrototypeOf, hasOwnProperty, is, isExtensible, isFrozen, isPrototypeOf, isSealed, keys, preventExtensions, propertyIsEnumerable, seal, setPrototypeOf, toLocaleString, toString, valueOf, values

Constructor Detail

SortedMap

publicSortedMap()

Constructor to create a new SortedMap.


SortedMap

publicSortedMap(comparator : Object)

Constructor to create a new SortedMap. The constructor takes a compare function as additional parameter. This comparator determines identity and the order of the element keys for this map. The order of the elements is determined with a comparator (see PropertyComparator) or with the help of the given function. The function must take two parameters and return a value <=-1 if the first parameter is smaller than the second, a value if >=1 if the first one is greater than the second parameter and a value in between like 0 if both are equal.

Parameters:

comparator - an instance of a PropertyComparator or a comparison function


Method Detail

clone

clone() : SortedMap

Returns a shallow copy of this map.

Returns:

a shallow copy of this map.

firstKey

firstKey() : Object

Returns the first (lowest) key currently in this sorted map.

Returns:

the first (lowest) key currently in this sorted map.


headMap

headMap(key : Object) : SortedMap

Returns a view of the portion of this map whose keys are strictly less than toKey.

Parameters:

key - high endpoint (exclusive) of the headMap.

Returns:

a view of the portion of this map whose keys are strictly less than toKey.


lastKey

lastKey() : Object

Returns the last (highest) key currently in this sorted map.

Returns:

the last (highest) key currently in this sorted map.


subMap

subMap(from : Object, to : Object) : SortedMap

Returns a view of the portion of this map whose keys range from fromKey, inclusive, to toKey, exclusive. (If fromKey and toKey are equal, the returned sorted map is empty.)

Parameters:

from - low endpoint (inclusive) of the subMap.

to - high endpoint (exclusive) of the subMap.

Returns:

a view of the portion of this map whose keys range from fromKey, inclusive, to toKey, exclusive.


tailMap

tailMap(key : Object) : SortedMap

Returns a view of the portion of this map whose keys are greater than or equal to fromKey. The returned sorted map is backed by this map, so changes in the returned sorted map are reflected in this map, and vice-versa. The returned sorted map supports all optional map operations.

Parameters:

key - low endpoint (inclusive) of the tailMap.

Returns:

a view of the portion of this map whose keys are greater than or equal to fromKey.