Package io.jawk.jrt

Class HashAssocArray

java.lang.Object

java.util.AbstractMap<K,V>

java.util.HashMap<Object,Object>

io.jawk.jrt.HashAssocArray

All Implemented Interfaces:

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

Direct Known Subclasses:

ListAssocArray

public class HashAssocArray
extends HashMap<Object,Object>
implements AssocArray

An AWK associative array backed by a HashMap.

Keys are not kept in any particular order. This is the default implementation used when sorted keys are not required.

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
HashAssocArray()

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 HashMap 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.HashMap

clear, clone, compute, computeIfAbsent, computeIfPresent, containsKey, containsValue, entrySet, forEach, getOrDefault, isEmpty, keySet, merge, putAll, putIfAbsent, remove, replace, replace, replaceAll, size, values

Methods inherited from class java.util.AbstractMap

equals, hashCode

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, entrySet, equals, forEach, getOrDefault, hashCode, isEmpty, keySet, merge, putAll, putIfAbsent, remove, replace, replace, replaceAll, size, values

Constructor Details

HashAssocArray

public HashAssocArray()

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 HashMap<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 HashMap<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 HashMap<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 HashMap 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