The dictionaryvalueexists statement returns true or false depending on whether or not a key/value pair exists in a dictionary (see Data Dictionaries).
This statement has three parameters:
dictionary – name of the field or variable that contains the dictionary (must contain binary data).
key – is the name of the key you want to check.
result – is the field or variable to receive the true/false value.
The dictionaryvalueexists statement takes a key name and determines whether it exists in the dictionary collection. For example, suppose you created a dictionary and stored it in variable named mailto.
fileglobal mailto,exists mailto=initializedictionary("Address","3987 Olive","City","Tustin","State","CA","Zip","92841")
Later, you could use the dictionaryvalueexists statement to check whether different values exist in this dictionary:
dictionaryvalueexists mailto,"Address",exists ☞ -1 (true) dictionaryvalueexists mailto,"Country",exists ☞ 0 (false)
Of course, the contents of a dictionary could change over time – for example, a Country value could be added to this dictionary:
After this change is made, the dictionaryvalueexists statement will now return true when you check for the Country value:
dictionaryvalueexists mailto,"Country",exists ☞ -1 (true)
|10.0||Updated||Carried over from Panorama 6.0, but uses new internal dictionary format|