dictionaryvalueexists(
DICTIONARY
,
KEY
)

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

VersionStatusNotes
10.0No ChangeCarried over from Panorama 6.0