Package gnu.trove.map

Interface TLongShortMap

  • All Known Implementing Classes:
    TLongShortHashMap

    public interface TLongShortMap
    Interface for a primitive map of long keys and short values.
    • Method Summary

      All Methods Instance Methods Abstract Methods 
      Modifier and Type Method Description
      short adjustOrPutValue​(long key, short adjust_amount, short put_amount)
      Adjusts the primitive value mapped to the key if the key is present in the map.
      boolean adjustValue​(long key, short amount)
      Adjusts the primitive value mapped to key.
      void clear()
      Empties the map.
      boolean containsKey​(long key)
      Checks for the present of key in the keys of the map.
      boolean containsValue​(short val)
      Checks for the presence of val in the values of the map.
      boolean forEachEntry​(TLongShortProcedure procedure)
      Executes procedure for each key/value entry in the map.
      boolean forEachKey​(TLongProcedure procedure)
      Executes procedure for each key in the map.
      boolean forEachValue​(TShortProcedure procedure)
      Executes procedure for each value in the map.
      short get​(long key)
      Retrieves the value for key
      long getNoEntryKey()
      Returns the value that will be returned from get(long) or put(long, short) if no entry exists for a given key.
      short getNoEntryValue()
      Returns the value that will be returned from get(long) or put(long, short) if no entry exists for a given key.
      boolean increment​(long key)
      Increments the primitive value mapped to key by 1
      boolean isEmpty()
      Returns true if this map contains no key-value mappings.
      TLongShortIterator iterator()  
      long[] keys()
      Returns the keys of the map as an array of long values.
      long[] keys​(long[] array)
      Returns the keys of the map.
      TLongSet keySet()
      Returns the keys of the map as a TLongSet
      short put​(long key, short value)
      Inserts a key/value pair into the map.
      void putAll​(TLongShortMap map)
      Put all the entries from the given map into this map.
      void putAll​(java.util.Map<? extends java.lang.Long,​? extends java.lang.Short> map)
      Put all the entries from the given Map into this map.
      short putIfAbsent​(long key, short value)
      Inserts a key/value pair into the map if the specified key is not already associated with a value.
      short remove​(long key)
      Deletes a key/value pair from the map.
      boolean retainEntries​(TLongShortProcedure procedure)
      Retains only those entries in the map for which the procedure returns a true value.
      int size()
      Returns an int value that is the number of elements in the map.
      void transformValues​(TShortFunction function)
      Transform the values in this map using function.
      TShortCollection valueCollection()
      Returns the values of the map as a TShortCollection
      short[] values()
      Returns the values of the map as an array of #e# values.
      short[] values​(short[] array)
      Returns the values of the map using an existing array.
    • Method Detail

      • getNoEntryKey

        long getNoEntryKey()
        Returns the value that will be returned from get(long) or put(long, short) if no entry exists for a given key. The default value is generally zero, but can be changed during construction of the collection.
        Returns:
        the value that represents a null key in this collection.
      • getNoEntryValue

        short getNoEntryValue()
        Returns the value that will be returned from get(long) or put(long, short) if no entry exists for a given key. The default value is generally zero, but can be changed during construction of the collection.
        Returns:
        the value that represents a null value in this collection.
      • put

        short put​(long key,
                  short value)
        Inserts a key/value pair into the map.
        Parameters:
        key - an long value
        value - an short value
        Returns:
        the previous value associated with key, or the "no entry" value if none was found (see getNoEntryValue()).
      • putIfAbsent

        short putIfAbsent​(long key,
                          short value)
        Inserts a key/value pair into the map if the specified key is not already associated with a value.
        Parameters:
        key - an long value
        value - an short value
        Returns:
        the previous value associated with key, or the "no entry" value if none was found (see getNoEntryValue()).
      • putAll

        void putAll​(java.util.Map<? extends java.lang.Long,​? extends java.lang.Short> map)
        Put all the entries from the given Map into this map.
        Parameters:
        map - The Map from which entries will be obtained to put into this map.
      • putAll

        void putAll​(TLongShortMap map)
        Put all the entries from the given map into this map.
        Parameters:
        map - The map from which entries will be obtained to put into this map.
      • get

        short get​(long key)
        Retrieves the value for key
        Parameters:
        key - an long value
        Returns:
        the previous value associated with key, or the "no entry" value if none was found (see getNoEntryValue()).
      • clear

        void clear()
        Empties the map.
      • isEmpty

        boolean isEmpty()
        Returns true if this map contains no key-value mappings.
        Returns:
        true if this map contains no key-value mappings
      • remove

        short remove​(long key)
        Deletes a key/value pair from the map.
        Parameters:
        key - an long value
        Returns:
        the previous value associated with key, or the "no entry" value if none was found (see getNoEntryValue()).
      • size

        int size()
        Returns an int value that is the number of elements in the map.
        Returns:
        an int value that is the number of elements in the map.
      • keySet

        TLongSet keySet()
        Returns the keys of the map as a TLongSet
        Returns:
        the keys of the map as a TLongSet
      • keys

        long[] keys()
        Returns the keys of the map as an array of long values.
        Returns:
        the keys of the map as an array of long values.
      • keys

        long[] keys​(long[] array)
        Returns the keys of the map.
        Parameters:
        array - the array into which the elements of the list are to be stored, if it is big enough; otherwise, a new array of the same type is allocated for this purpose.
        Returns:
        the keys of the map as an array.
      • valueCollection

        TShortCollection valueCollection()
        Returns the values of the map as a TShortCollection
        Returns:
        the values of the map as a TShortCollection
      • values

        short[] values()
        Returns the values of the map as an array of #e# values.
        Returns:
        the values of the map as an array of #e# values.
      • values

        short[] values​(short[] array)
        Returns the values of the map using an existing array.
        Parameters:
        array - the array into which the elements of the list are to be stored, if it is big enough; otherwise, a new array of the same type is allocated for this purpose.
        Returns:
        the values of the map as an array of #e# values.
      • containsValue

        boolean containsValue​(short val)
        Checks for the presence of val in the values of the map.
        Parameters:
        val - an short value
        Returns:
        a boolean value
      • containsKey

        boolean containsKey​(long key)
        Checks for the present of key in the keys of the map.
        Parameters:
        key - an long value
        Returns:
        a boolean value
      • iterator

        TLongShortIterator iterator()
        Returns:
        a TLongShortIterator with access to this map's keys and values
      • forEachKey

        boolean forEachKey​(TLongProcedure procedure)
        Executes procedure for each key in the map.
        Parameters:
        procedure - a TLongProcedure value
        Returns:
        false if the loop over the keys terminated because the procedure returned false for some key.
      • forEachValue

        boolean forEachValue​(TShortProcedure procedure)
        Executes procedure for each value in the map.
        Parameters:
        procedure - a T#F#Procedure value
        Returns:
        false if the loop over the values terminated because the procedure returned false for some value.
      • forEachEntry

        boolean forEachEntry​(TLongShortProcedure procedure)
        Executes procedure for each key/value entry in the map.
        Parameters:
        procedure - a TOLongShortProcedure value
        Returns:
        false if the loop over the entries terminated because the procedure returned false for some entry.
      • transformValues

        void transformValues​(TShortFunction function)
        Transform the values in this map using function.
        Parameters:
        function - a TShortFunction value
      • retainEntries

        boolean retainEntries​(TLongShortProcedure procedure)
        Retains only those entries in the map for which the procedure returns a true value.
        Parameters:
        procedure - determines which entries to keep
        Returns:
        true if the map was modified.
      • increment

        boolean increment​(long key)
        Increments the primitive value mapped to key by 1
        Parameters:
        key - the key of the value to increment
        Returns:
        true if a mapping was found and modified.
      • adjustValue

        boolean adjustValue​(long key,
                            short amount)
        Adjusts the primitive value mapped to key.
        Parameters:
        key - the key of the value to increment
        amount - the amount to adjust the value by.
        Returns:
        true if a mapping was found and modified.
      • adjustOrPutValue

        short adjustOrPutValue​(long key,
                               short adjust_amount,
                               short put_amount)
        Adjusts the primitive value mapped to the key if the key is present in the map. Otherwise, the initial_value is put in the map.
        Parameters:
        key - the key of the value to increment
        adjust_amount - the amount to adjust the value by
        put_amount - the value put into the map if the key is not initial present
        Returns:
        the value present in the map after the adjustment or put operation