it.unimi.dsi.fastutil.objects
Class AbstractObject2ByteFunction<K>

java.lang.Object
  extended by it.unimi.dsi.fastutil.objects.AbstractObject2ByteFunction<K>
All Implemented Interfaces:
Function<K,Byte>, Object2ByteFunction<K>, Serializable
Direct Known Subclasses:
AbstractObject2ByteMap, Object2ByteFunctions.EmptyFunction, Object2ByteFunctions.Singleton, Object2ByteFunctions.SynchronizedFunction, Object2ByteFunctions.UnmodifiableFunction

public abstract class AbstractObject2ByteFunction<K>
extends Object
implements Object2ByteFunction<K>, Serializable

An abstract class providing basic methods for functions implementing a type-specific interface.

Optional operations just throw an UnsupportedOperationException. Generic versions of accessors delegate to the corresponding type-specific counterparts following the interface rules (they take care of returning null on a missing key).

This class handles directly a default return value (including methods to access it). Instances of classes inheriting from this class have just to return defRetValue to denote lack of a key in type-specific methods. The value is serialized.

Implementing subclasses have just to provide type-specific get(), type-specific containsKey(), and size() methods.

See Also:
Serialized Form

Method Summary
 void clear()
          Removes all associations from this function (optional operation).
 byte defaultReturnValue()
          Gets the default return value.
 void defaultReturnValue(byte rv)
          Sets the default return value.
 Byte get(Object ok)
          Delegates to the corresponding type-specific method, taking care of returning null on a missing key.
 byte put(K key, byte value)
          Adds a pair to the map.
 Byte put(K ok, Byte ov)
          Delegates to the corresponding type-specific method, taking care of returning null on a missing key.
 Byte remove(Object ok)
          Delegates to the corresponding type-specific method, taking care of returning null on a missing key.
 byte removeByte(Object key)
          Removes the mapping with the given key.
 
Methods inherited from class java.lang.Object
equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 
Methods inherited from interface it.unimi.dsi.fastutil.objects.Object2ByteFunction
getByte
 
Methods inherited from interface it.unimi.dsi.fastutil.Function
containsKey, size
 

Method Detail

defaultReturnValue

public void defaultReturnValue(byte rv)
Description copied from interface: Object2ByteFunction
Sets the default return value. This value must be returned by type-specific versions of get(), put() and remove() to denote that the map does not contain the specified key. It must be 0/false/null by default.

Specified by:
defaultReturnValue in interface Object2ByteFunction<K>
Parameters:
rv - the new default return value.
See Also:
Object2ByteFunction.defaultReturnValue()

defaultReturnValue

public byte defaultReturnValue()
Description copied from interface: Object2ByteFunction
Gets the default return value.

Specified by:
defaultReturnValue in interface Object2ByteFunction<K>
Returns:
the current default return value.

put

public byte put(K key,
                byte value)
Description copied from interface: Object2ByteFunction
Adds a pair to the map.

Specified by:
put in interface Object2ByteFunction<K>
Parameters:
key - the key.
value - the value.
Returns:
the old value, or the default return value if no value was present for the given key.
See Also:
Function.put(Object,Object)

removeByte

public byte removeByte(Object key)
Description copied from interface: Object2ByteFunction
Removes the mapping with the given key.

Specified by:
removeByte in interface Object2ByteFunction<K>
Returns:
the old value, or the default return value if no value was present for the given key.
See Also:
Function.remove(Object)

clear

public void clear()
Description copied from interface: Function
Removes all associations from this function (optional operation).

Specified by:
clear in interface Function<K,Byte>
See Also:
Map.clear()

get

public Byte get(Object ok)
Delegates to the corresponding type-specific method, taking care of returning null on a missing key.

This method must check whether the provided key is in the map using containsKey(). Thus, it probes the map twice. Implementors of subclasses should override it with a more efficient method.

Specified by:
get in interface Function<K,Byte>
Parameters:
ok - the key.
Returns:
the corresponding value, or null if no value was present for the given key.
See Also:
Map.get(Object)

put

public Byte put(K ok,
                Byte ov)
Delegates to the corresponding type-specific method, taking care of returning null on a missing key.

This method must check whether the provided key is in the map using containsKey(). Thus, it probes the map twice. Implementors of subclasses should override it with a more efficient method.

Specified by:
put in interface Function<K,Byte>
Parameters:
ok - the key.
ov - the value.
Returns:
the old value, or null if no value was present for the given key.
See Also:
Map.put(Object,Object)

remove

public Byte remove(Object ok)
Delegates to the corresponding type-specific method, taking care of returning null on a missing key.

This method must check whether the provided key is in the map using containsKey(). Thus, it probes the map twice. Implementors of subclasses should override it with a more efficient method.

Specified by:
remove in interface Function<K,Byte>
Returns:
the old value, or null if no value was present for the given key.
See Also:
Map.remove(Object)