The dictionaryvalueexists( function returns true or false depending on whether or not a key/value pair exists in a dictionary (see Data Dictionaries).
Parameters
This function has two parameters:
dictionary – is the 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.
Description
The dictionaryvalueexists( function 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
mailto=initializedictionary("Address","3987 Olive","City","Tustin","State","CA","Zip","92841")
Later, you could use the dictionaryvalueexists( function to check whether different values exist in this dictionary:
dictionaryvalueexists(mailto,"Address") ☞ -1 (true)
dictionaryvalueexists(mailto,"Country") ☞ 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( function will now return true when you check for the Country value:
dictionaryvalueexists(mailto,"Country") ☞ -1 (true)
See Also
History
Version | Status | Notes |
10.0 | No Change | Carried over from Panorama 6.0 |