The dictionaryvalueexists statement returns true or false depending on whether or not a key/value pair exists in a dictionary (see Data Dictionaries).
Parameters
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.
Description
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:
mailto=changedictionaryvalues(mailto,"Country","United States")
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)
See Also
History
Version | Status | Notes |
10.0 | Updated | Carried over from Panorama 6.0, but uses new internal dictionary format |