Roku Object Reference - imaginArt

oAssociativeArray ()
An associative array (also knows as a map, dictionary or hash table) allows objects to be associated with
string keys. The roAssociativeArray class implements the ifAssociativeArray interface.
This object is created with no parameters:
• CreateObject("roAssociativeArray")
The ifAssociativeArray interface provides:
• AddReplace(key As String, value As Object) As Void
o Add a new entry to the array associating the supplied object with the supplied string. Only one
object may be associated with a string so any existing object is discarded.
• Lookup(key As String) As Object
o Look for an object in the array associated with the specified string. If there is no object
associated with the string then an object implementing ifInt containing zero is returned.
• DoesExist(key As String) As Boolean
o Look for an object in the array associated with the specified string. If there is no associated
object then false is returned. If there is such an object then true is returned.
• Delete(key As String) As Boolean
o Look for an object in the array associated with the specified string. If there is such an object
then it is deleted and true is returned. If not then false is returned.
• Clear() As Void
o Remove all objects from the associative array.
Example:
aa = CreateObject("roAssociativeArray")
aa.AddReplace("Bright", "Sign")
aa.AddReplace("TMOL", 42)
print aa.Lookup("TMOL")
print aa.Lookup("Bright")
Produces:
42
Sign
42