Name | Description |
---|---|
roAssociativeArray | An associative array allows objects to be associated with string keys |
roSGNode | The roSGNode object is the BrightScript equivalent of SceneGraph XML file node creation |
Adds a new entry to the array associating the supplied value with the supplied key string. Only one value may be associated with a key. If the key is already associated with a value, the existing value is discarded.
Name | Type | Description |
---|---|---|
value | Dynamic | The value of the key to be added to the associative array. |
key | String | The key to be added to the associative array. |
Returns the value in the array associated with the specified key. The key comparison is case-insensitive, unless the SetModeCaseSensitive() method has been called.
Name | Type | Description |
---|---|---|
key | String | The key associated with the value to be retrieved from the associative array. |
Returns the value in the array associated with the specified key. If there is no value associated with the key, the type "invalid" is returned.
Same as the Lookup() method except that the key comparison is always case insensitive, regardless of the case mode.
Name | Type | Description |
---|---|---|
key | String | The key (case-insensitive) associated with the value to be retrieved from the associative array. |
Returns the value in the array associated with the specified key. If there is no value associated with the key, the type "invalid" is returned.
Looks for an entry in the associative array associated with the specified key.
Name | Type | Description |
---|---|---|
key | String | The key associated with the entry to be checked. |
A flag indicating whether an entry is associated with the specified key exists. If there is no associated object then false is returned. If there is such an object then true is returned.
Deletes an entry from an associative array based on the key.
Name | Type | Description |
---|---|---|
key | String | The key associated with the entry to be deleted. |
A flag indicating whether an entry is associated with the specified key exists. If there is no associated object then false is returned. If there is such an object then true is returned.
Remove all key/values from the associative array.
Returns an array containing the associative array keys in lexicographical order.
An array of associative array keys.
Returns an array containing the associative array key/value pairs in lexicographical order of key.
An array of associative array keys/value pairs.
aa = {one:1, two:2, three:3}
for each item in aa.Items()
print item.key, item.value
end for
REM prints "one 1", "three 3", "two 2"
Makes all subsequent associative array lookups case sensitive (by default, lookups are case insensitive).
Appends an associative array to this calling object. If any key in the aa parameter is already associated with a value in the calling object, the current value is discarded and is replaced with the value provided in the aa parameter.
Name | Type | Description |
---|---|---|
aa | Object | The associative array to be appended to the calling object. |
The function returns invalid
.
Returns the number of keys in the associative array.
The number of keys in the associative array.