Package com.hexaly.modeler

Class HxmMap

java.lang.Object
com.hexaly.modeler.HxmMap
All Implemented Interfaces:
AutoCloseable, Iterable<HxmMap.Entry>
public class HxmMap extends Object implements Iterable<HxmMap.Entry>, AutoCloseable
An HxmMap is a data structure mapping keys to values. A map is both an associative table and an array. Setting a value to an existing key will overwrite any value previously set for that key. When used as an array-like structure, adding a new unkeyed element to an HxmMap with addValue(HxmValue) automatically assigns an integer key to the element equal to the largest integer key already present plus one, or zero if no integer key exists. Most of the functions below exist in multiple versions: Values and keys can be manipulated through their native type (like int, double, String, HxmMap, HxmFunction...) or manipulated with an HxmValue which is a container that can hold any type of value. Using the native type is more convenient and results in less overhead most of the time. HxmValue should only be used when you don't know the type of the manipulated value. The iterators returned by the method iterator() follow the fail-fast convention: if the map is structurally modified after the creation of an iterator (by using the methods add, set, unset or clear), the iterator will throw an exception. In other words, you can't modify a map while you are iterating over it.
Since:
10.0

  • Method Details

    • close

      public void close()

      Releases the reference. If this map was already released, returns immediately and does nothing. Invoking any method on this object after this operation will throw an exception.

      Note: Releasing a reference does not necessarily imply that the underlying map object is destroyed. It is only destroyed if no more references point to it.

      Specified by:
      close in interface AutoCloseable
      Since:
      11.5

    • count

      public long count()
      Returns the number of elements in the map.

    • clear

      public void clear()
      Erases all elements from the map. After this call, count() returns zero.

    • addValue

      public void addValue(HxmValue value)
      Adds the given value to the map with a key corresponding to the largest integer key present in the map plus one, or zero if no integer key exists.
      Parameters:
      value - Value to add in the map.

    • addInt

      public void addInt(long value)
      Adds the given integer value to the map with a key corresponding to the largest integer key present in the map plus one, or zero if no integer key exists.
      Parameters:
      value - Integer value to add in the map.

    • addDouble

      public void addDouble(double value)
      Adds the given double value to the map with a key corresponding to the largest integer key present in the map plus one, or zero if no integer key exists.
      Parameters:
      value - Double value to add in the map.

    • addBool

      public void addBool(boolean value)
      Adds the given boolean value to the map with a key corresponding to the largest integer key present in the map plus one, or zero if no integer key exists.
      Parameters:
      value - Boolean value to add in the map.

    • addExpression

      public void addExpression(HxExpression expr)
      Adds the given HxExpression to the map with a key corresponding to the largest integer key present in the map plus one, or zero if no integer key exists.
      Parameters:
      expr - HxExpression to add in the map.

    • addMap

      public void addMap(HxmMap map)
      Adds the given HxmMap to the map with a key corresponding to the largest integer key present in the map plus one, or zero if no integer key exists.
      Parameters:
      map - Map to add in the map.

    • addModule

      public void addModule(HxmModule module)
      Adds the given HxmModule to the map with a key corresponding to the largest integer key present in the map plus one, or zero if no integer key exists.
      Parameters:
      module - Module to add in the map.

    • addClass

      public void addClass(HxmClass clazz)
      Adds the given HxmClass to the map with a key corresponding to the largest integer key present in the map plus one, or zero if no integer key exists.
      Parameters:
      clazz - Class to add in the map.

    • addString

      public void addString(String str)
      Adds the given String value to the map with a key corresponding to the largest integer key present in the map plus one, or zero if no integer key exists.
      Parameters:
      str - String value to add in the map.

    • addFunction

      public void addFunction(HxmFunction function)
      Adds the given HxmFunction to the map with a key corresponding to the largest integer key present in the map plus one, or zero if no integer key exists.
      Parameters:
      function - Function to add in the map.

    • getValue

      public HxmValue getValue(String key)
      Returns the value associated with the given key as an HxmValue. If no value is associated with the key, an HxmValue representing nil is returned.
      Parameters:
      key - String key
      Returns:
      HxmValue associated with the key.

    • getInt

      public long getInt(String key)
      Returns the integer value associated with the given key. The value must exist and must be an integer.
      Parameters:
      key - String key.
      Returns:
      Integer value associated with the key.

    • getDouble

      public double getDouble(String key)
      Returns the double value associated with the given key. The value must exist and must be a double.
      Parameters:
      key - String key.
      Returns:
      Double value associated with the key.

    • getBool

      public boolean getBool(String key)
      Returns the boolean value associated with the given key. The value must exist and must be a boolean.
      Parameters:
      key - String key.
      Returns:
      Boolean value associated with the key.

    • getString

      public String getString(String key)
      Returns the String value associated with the given key. The value must exist and must be a String.
      Parameters:
      key - String key.
      Returns:
      String value associated with the key.

    • getModule

      public HxmModule getModule(String key)
      Returns the HxmModule associated with the given key. The value must exist and must be a module.
      Parameters:
      key - String key.
      Returns:
      Module associated with the key.

    • getClass

      public HxmClass getClass(String key)
      Returns the HxmClass associated with the given key. The value must exist and must be a class.
      Parameters:
      key - String key.
      Returns:
      Class associated with the key.

    • getFunction

      public HxmFunction getFunction(String key)
      Returns the HxmFunction associated with the given key. The value must exist and must be a function.
      Parameters:
      key - String key.
      Returns:
      Function associated with the key.

    • getMap

      public HxmMap getMap(String key)
      Returns the HxmMap associated with the given key. The value must exist and must be a map.
      Parameters:
      key - String key.
      Returns:
      Map associated with the key.

    • getExpression

      public HxExpression getExpression(String key)
      Returns the HxExpression associated with the given key. The value must exist and must be an expression.
      Parameters:
      key - String key.
      Returns:
      Expression associated with the key.

    • setValue

      public void setValue(String key, HxmValue value)
      Associates the HxmValue to the given key in the map. If the value is nil, this has the same effect as unset(java.lang.String). If the map already contained an association for the key, the previous value is replaced.
      Parameters:
      key - String key.
      value - HxmValue to set.

    • setInt

      public void setInt(String key, long value)
      Associates the integer value to the given key in the map. If the map already contained an association for the key, the previous value is replaced.
      Parameters:
      key - String key.
      value - Integer value to set.

    • setDouble

      public void setDouble(String key, double value)
      Associates the double value to the given key in the map. If the map already contained an association for the key, the previous value is replaced.
      Parameters:
      key - String key.
      value - Double value to set.

    • setBool

      public void setBool(String key, boolean value)
      Associates the boolean value to the given key in the map. If the map already contained an association for the key, the previous value is replaced.
      Parameters:
      key - String key.
      value - Boolean value to set.

    • setString

      public void setString(String key, String str)
      Associates the String value to the given key in the map. If the map already contained an association for the key, the previous value is replaced.
      Parameters:
      key - String key.
      str - String value to set.

    • setModule

      public void setModule(String key, HxmModule module)
      Associates the HxmModule to the given key in the map. If the map already contained an association for the key, the previous value is replaced.
      Parameters:
      key - String key.
      module - Module to set.

    • setClass

      public void setClass(String key, HxmClass clazz)
      Associates the HxmClass to the given key in the map. If the map already contained an association for the key, the previous value is replaced.
      Parameters:
      key - String key.
      clazz - Class to set.

    • setFunction

      public void setFunction(String key, HxmFunction function)
      Associates the HxmFunction to the given key in the map. If the map already contained an association for the key, the previous value is replaced.
      Parameters:
      key - String key.
      function - Function to set.

    • setMap

      public void setMap(String key, HxmMap map)
      Associates the HxmMap to the given key in the map. If the map already contained an association for the key, the previous value is replaced.
      Parameters:
      key - String key.
      map - Map to set.

    • setExpression

      public void setExpression(String key, HxExpression expr)
      Associates the HxExpression to the given key in the map. If the map already contained an association for the key, the previous value is replaced.
      Parameters:
      key - String key.
      expr - Expression to set.

    • getValue

      public HxmValue getValue(long key)
      Returns the value associated with the given key as an HxmValue. If no value is associated with the key, an HxmValue representing nil is returned.
      Parameters:
      key - Integer key
      Returns:
      HxmValue associated with the key.

    • getInt

      public long getInt(long key)
      Returns the integer value associated with the given key. The value must exist and must be an integer.
      Parameters:
      key - Integer key.
      Returns:
      Integer value associated with the key.

    • getDouble

      public double getDouble(long key)
      Returns the double value associated with the given key. The value must exist and must be a double.
      Parameters:
      key - Integer key.
      Returns:
      Double value associated with the key.

    • getBool

      public boolean getBool(long key)
      Returns the boolean value associated with the given key. The value must exist and must be a boolean.
      Parameters:
      key - Integer key.
      Returns:
      Boolean value associated with the key.

    • getString

      public String getString(long key)
      Returns the String value associated with the given key. The value must exist and must be a String.
      Parameters:
      key - Integer key.
      Returns:
      String value associated with the key.

    • getModule

      public HxmModule getModule(long key)
      Returns the HxmModule associated with the given key. The value must exist and must be a module.
      Parameters:
      key - Integer key.
      Returns:
      Module associated with the key.

    • getClass

      public HxmClass getClass(long key)
      Returns the HxmClass associated with the given key. The value must exist and must be a clazz.
      Parameters:
      key - Integer key.
      Returns:
      Clazz associated with the key.

    • getFunction

      public HxmFunction getFunction(long key)
      Returns the HxmFunction associated with the given key. The value must exist and must be a function.
      Parameters:
      key - Integer key.
      Returns:
      Function associated with the key.

    • getMap

      public HxmMap getMap(long key)
      Returns the HxmMap associated with the given key. The value must exist and must be a map.
      Parameters:
      key - Integer key.
      Returns:
      Map associated with the key.

    • getExpression

      public HxExpression getExpression(long key)
      Returns the HxExpression associated with the given key. The value must exist and must be an expression.
      Parameters:
      key - Integer key.
      Returns:
      Expression associated with the key.

    • setValue

      public void setValue(long key, HxmValue value)
      Associates the HxmValue to the given key. If the HxmValue is nil, this has the same effect as unset(java.lang.String). If the map already contained an association for the key, the previous value is replaced.
      Parameters:
      key - Integer key.
      value - HxmValue to set.

    • setInt

      public void setInt(long key, long value)
      Associates the integer value to the given key in the map. If the map already contained an association for the key, the previous value is replaced.
      Parameters:
      key - Integer key.
      value - Integer value to set.

    • setDouble

      public void setDouble(long key, double value)
      Associates the double value to the given key in the map. If the map already contained an association for the key, the previous value is replaced.
      Parameters:
      key - Integer key.
      value - Double value to set.

    • setBool

      public void setBool(long key, boolean value)
      Associates the boolean value to the given key in the map. If the map already contained an association for the key, the previous value is replaced.
      Parameters:
      key - Integer key.
      value - Boolean value to set.

    • setString

      public void setString(long key, String str)
      Associates the String value to the given key in the map. If the map already contained an association for the key, the previous value is replaced.
      Parameters:
      key - Integer key.
      str - String value to set.

    • setModule

      public void setModule(long key, HxmModule module)
      Associates the HxmModule to the given key in the map. If the map already contained an association for the key, the previous value is replaced.
      Parameters:
      key - Integer key.
      module - Module to set.

    • setClass

      public void setClass(long key, HxmClass clazz)
      Associates the HxmClass to the given key in the map. If the map already contained an association for the key, the previous value is replaced.
      Parameters:
      key - Integer key.
      clazz - Class to set.

    • setFunction

      public void setFunction(long key, HxmFunction function)
      Associates the HxmFunction to the given key in the map. If the map already contained an association for the key, the previous value is replaced.
      Parameters:
      key - Integer key.
      function - Function to set.

    • setMap

      public void setMap(long key, HxmMap map)
      Associates the HxmMap to the given key in the map. If the map already contained an association for the key, the previous value is replaced.
      Parameters:
      key - Integer key.
      map - Map to set.

    • setExpression

      public void setExpression(long key, HxExpression expr)
      Associates the HxExpression to the given key in the map. If the map already contained an association for the key, the previous value is replaced.
      Parameters:
      key - Integer key.
      expr - Expression to set.

    • getValue

      public HxmValue getValue(HxmValue key)
      Returns the value associated with the given key as an HxmValue. If no value is associated with the key, an HxmValue representing nil is returned.
      Parameters:
      key - HxmValue key
      Returns:
      Value associated with the key.

    • getInt

      public long getInt(HxmValue key)
      Returns the integer value associated with the given key. The value must exist and must be an integer.
      Parameters:
      key - HxmValue key.
      Returns:
      Integer value associated with the key.

    • getDouble

      public double getDouble(HxmValue key)
      Returns the double value associated with the given key. The value must exist and must be a double.
      Parameters:
      key - HxmValue key.
      Returns:
      Double value associated with the key.

    • getBool

      public boolean getBool(HxmValue key)
      Returns the boolean value associated with the given key. The value must exist and must be a boolean.
      Parameters:
      key - HxmValue key.
      Returns:
      Boolean value associated with the key.

    • getString

      public String getString(HxmValue key)
      Returns the String value associated with the given key. The value must exist and must be a String.
      Parameters:
      key - HxmValue key.
      Returns:
      String value associated with the key.

    • getModule

      public HxmModule getModule(HxmValue key)
      Returns the HxmModule associated with the given key. The value must exist and must be a module.
      Parameters:
      key - HxmValue key.
      Returns:
      Module associated with the key.

    • getClass

      public HxmClass getClass(HxmValue key)
      Returns the HxmClass associated with the given key. The value must exist and must be a class.
      Parameters:
      key - HxmValue key.
      Returns:
      Clazz associated with the key.

    • getFunction

      public HxmFunction getFunction(HxmValue key)
      Returns the HxmFunction associated with the given key. The value must exist and must be a function.
      Parameters:
      key - HxmValue key.
      Returns:
      Function associated with the key.

    • getMap

      public HxmMap getMap(HxmValue key)
      Returns the HxmMap associated with the given key. The value must exist and must be a map.
      Parameters:
      key - HxmValue key.
      Returns:
      Map associated with the key.

    • getExpression

      public HxExpression getExpression(HxmValue key)
      Returns the HxExpression associated with the given key. The value must exist and must be an expression.
      Parameters:
      key - HxmValue key.
      Returns:
      Expression associated with the key.

    • setValue

      public void setValue(HxmValue key, HxmValue value)
      Associates the HxmValue to the given key in the map. If the HxmValue is nil, this has the same effect as unset(java.lang.String). If the map already contained an association for the key, the previous value is replaced. The key must not be nil.
      Parameters:
      key - HxmValue key.
      value - HxmValue to set.

    • setInt

      public void setInt(HxmValue key, long value)
      Associates the integer value to the given key in the map. If the map already contained an association for the key, the previous value is replaced. The key must not be nil.
      Parameters:
      key - HxmValue key.
      value - Integer value to set.

    • setDouble

      public void setDouble(HxmValue key, double value)
      Associates the double value to the given key in the map. If the map already contained an association for the key, the previous value is replaced. The key must not be nil.
      Parameters:
      key - HxmValue key.
      value - Double value to set.

    • setBool

      public void setBool(HxmValue key, boolean value)
      Associates the boolean value to the given key in the map. If the map already contained an association for the key, the previous value is replaced. The key must not be nil.
      Parameters:
      key - HxmValue key.
      value - Boolean value to set.

    • setString

      public void setString(HxmValue key, String str)
      Associates the String value to the given key in the map. If the map already contained an association for the key, the previous value is replaced. The key must not be nil.
      Parameters:
      key - HxmValue key.
      str - String value to set.

    • setModule

      public void setModule(HxmValue key, HxmModule module)
      Associates the HxmModule to the given key in the map. If the map already contained an association for the key, the previous value is replaced. The key must not be nil.
      Parameters:
      key - HxmValue key.
      module - Module to set.

    • setClass

      public void setClass(HxmValue key, HxmClass clazz)
      Associates the HxmClass to the given key in the map. If the map already contained an association for the key, the previous value is replaced. The key must not be nil.
      Parameters:
      key - HxmValue key.
      clazz - Class to set.

    • setFunction

      public void setFunction(HxmValue key, HxmFunction function)
      Associates the HxmFunction to the given key in the map. If the map already contained an association for the key, the previous value is replaced. The key must not be nil.
      Parameters:
      key - HxmValue key.
      function - Function to set.

    • setMap

      public void setMap(HxmValue key, HxmMap map)
      Associates the HxmMap to the given key in the map. If the map already contained an association for the key, the previous value is replaced. The key must not be nil.
      Parameters:
      key - HxmValue key.
      map - Map to set.

    • setExpression

      public void setExpression(HxmValue key, HxExpression expr)
      Associates the HxExpression to the given key in the map. If the map already contained an association for the key, the previous value is replaced. The key must not be nil.
      Parameters:
      key - HxmValue key.
      expr - Expression to set.

    • unset

      public void unset(String key)
      Unsets the given key in the map if present. If the key doesn't exist in the map do nothing.
      Parameters:
      key - String key.

    • unset

      public void unset(long key)
      Unsets the given key in the map if present. If the key doesn't exist in the map do nothing.
      Parameters:
      key - Integer key.

    • unset

      public void unset(HxmValue key)
      Unsets the given key in the map if present. If the key doesn't exist in the map do nothing. The key must not be nil.
      Parameters:
      key - HxmValue key.

    • isDefined

      public boolean isDefined(String key)
      Returns true if the given key is defined in the map.
      Parameters:
      key - String key.

    • isDefined

      public boolean isDefined(int key)
      Returns true if the given key is defined in the map.
      Parameters:
      key - Integer key.

    • isDefined

      public boolean isDefined(HxmValue key)
      Returns true if the given key is defined in the map.
      Parameters:
      key - HxmValue key.

    • iterator

      public Iterator<HxmMap.Entry> iterator()
      Returns a read-only iterator over the contents of this map. The optional remove() operation is not supported.
      Specified by:
      iterator in interface Iterable<HxmMap.Entry>

    • asValue

      public HxmValue asValue()
      Returns the map as an HxmValue.

    • hashCode

      public int hashCode()
      Overrides:
      hashCode in class Object

    • equals

      public boolean equals(Object obj)
      Overrides:
      equals in class Object