Package io.jawk.jrt

Class SortedAssocArray

java.lang.Object

java.util.AbstractMap<K,V>

java.util.TreeMap<Object,Object>

io.jawk.jrt.SortedAssocArray

All Implemented Interfaces:

AssocArray, Serializable, Cloneable, Map<Object,Object>, NavigableMap<Object,Object>, SortedMap<Object,Object>

public class SortedAssocArray
extends TreeMap<Object,Object>
implements AssocArray

An AWK associative array backed by a TreeMap.

Keys are maintained in sorted order using AWK comparison semantics: numeric keys are compared numerically, string keys lexicographically, and mixed key types fall back to string comparison.

Author:

MetricsHub

See Also:

• Serialized Form

Nested Class Summary

Nested classes/interfaces inherited from class java.util.AbstractMap

AbstractMap.SimpleEntry<K extends Object,V extends Object>, AbstractMap.SimpleImmutableEntry<K extends Object,V extends Object>

Nested classes/interfaces inherited from interface java.util.Map

Map.Entry<K extends Object,V extends Object>

Field Summary

Fields inherited from interface io.jawk.jrt.AssocArray

BLANK

Constructor Summary

Constructors

Constructor	Description
SortedAssocArray()	Creates a new sorted associative array using AWK key ordering.

Method Summary

Modifier and Type	Method	Description
Object	get(Object key)	Returns the value to which the specified key is mapped, normalizing the key first.
String	getMapVersion()	Returns the specification version of the underlying TreeMap class.
Object	put(Object key, Object value)	Associates the specified value with the specified key, normalizing the key to a Long when the key is a valid integer string.
Object	remove(Object key)	Removes the mapping for the specified key, trying both the original and its Long equivalent.
String	toString()

Methods inherited from class java.util.TreeMap

ceilingEntry, ceilingKey, clear, clone, comparator, containsKey, containsValue, descendingKeySet, descendingMap, entrySet, firstEntry, firstKey, floorEntry, floorKey, forEach, headMap, headMap, higherEntry, higherKey, keySet, lastEntry, lastKey, lowerEntry, lowerKey, navigableKeySet, pollFirstEntry, pollLastEntry, putAll, replace, replace, replaceAll, size, subMap, subMap, tailMap, tailMap, values

Methods inherited from class java.util.AbstractMap

equals, hashCode, isEmpty

Methods inherited from class java.lang.Object

getClass, notify, notifyAll, wait, wait, wait

Methods inherited from interface io.jawk.jrt.AssocArray

isIn, mapString, put

Methods inherited from interface java.util.Map

clear, compute, computeIfAbsent, computeIfPresent, containsKey, containsValue, equals, forEach, getOrDefault, hashCode, isEmpty, merge, putAll, putIfAbsent, remove, replace, replace, replaceAll, size

Constructor Details

SortedAssocArray

public SortedAssocArray()

Creates a new sorted associative array using AWK key ordering.

Method Details

get

public Object get(Object key)

Returns the value to which the specified key is mapped, normalizing the key first. If the key does not exist, a blank (UninitializedObject) is inserted and returned, as required by AWK semantics.

Specified by:

get in interface Map<Object,Object>

Overrides:

get in class TreeMap<Object,Object>

Parameters:

key - the key whose associated value is to be returned

Returns:

the value associated with the key, or a blank value if not found

put

public Object put(Object key,
 Object value)

Associates the specified value with the specified key, normalizing the key to a Long when the key is a valid integer string.

Specified by:

put in interface Map<Object,Object>

Overrides:

put in class TreeMap<Object,Object>

Parameters:

key - the key

value - the value

Returns:

the previous value associated with the key, or null

remove

public Object remove(Object key)

Removes the mapping for the specified key, trying both the original and its Long equivalent.

Specified by:

remove in interface Map<Object,Object>

Overrides:

remove in class TreeMap<Object,Object>

Parameters:

key - the key whose mapping is to be removed

Returns:

the previous value associated with the key, or null

getMapVersion

public String getMapVersion()

Returns the specification version of the underlying TreeMap class.

Specified by:

getMapVersion in interface AssocArray

Returns:

the specification version string, or null if unavailable

toString

public String toString()

Overrides:

toString in class AbstractMap<Object,Object>

Throws:

AwkRuntimeException - always, to prevent accidental use of AbstractMap.toString() in an AWK evaluation context