The copypartialdictionary( function partially copies a dictionary (see Data Dictionaries).
This function has two parameters:
dictionary – is the name of the field or variable that contains the original dictionary (must contain binary data).
key – is the name of the key to copy. If you need to copy more than one key/value pair, more than one key parameter can be used.
The copypartialdictionary( function takes one or more key names and copies the associated key/value pairs from the original dictionary into a new one. For example, suppose you created a dictionary and stored it in variable named contact.
fileglobal contact,mailto contact=initializedictionary("First","John","Last","Wilson", "Address","3987 Olive","City","Tustin","State","CA","Zip","92841", "Phone","562-309-5923","Email","firstname.lastname@example.org")
Later, you could use the copypartialdictionary( function to create a second dictionary, called mailto, that contains just the address information (without the phone number, e-mail, or any other entries that may have been added to the original dictionary):
|10.0||Updated||Carried over from Panorama 6.0, but now available as a function. Also, this operation no longer corrupts the dictionary if the same key is listed more than once.|