AddOnce

Description

Calling target.hash_table.AddOnce adds a key and a value to the hash table only if there is no value under that existing key. If the specified key already has a value associated with it then nothing occurs.

Syntax

trg.hash_table.AddOnce key, value

Key - Input the key of the value you want to add.

Value - Input the value you want to add.

Return value

This function returns a boolean true/false result depending on whether the value was added or not.

Sample

'---------- Start ----------

Function Start

Dim retval

trg.hash_table.Add "a", 11

if trg.hash_table.AddOnce( "a", 66 ) = false then

trg.Message( "The value was not added" )

else trg.Message( "The value was added" )

end if

End Function

In this case the value would not be added because there is already a value associated with the "a" key.