copypartialdictionary
SOURCEDICTIONARY
,
TARGETDICTIONARY
,
KEY

The copypartialdictionary statement builds a new dictionary and initializes it with values from an existing dictionary (see Data Dictionaries).


Parameters

This statement has three parameters:

sourcedictionary – name of the field or variable that contains the original dictionary (must contain binary data).

targetdictionary – name of the field or variable that will contain the new dictionary.

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.


Description

The copypartialdictionary statement 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 a 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","jwilson@someisp.com")

Later, you could use the copypartialdictionary statement to create a second dictionary, callled 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):

copypartialdictionary contact,mailto,"Address","City","State","Zip"

Note: For better peformance, use the copypartialdictionary( function instead of this statement.


See Also


History

VersionStatusNotes
10.0UpdatedCarried over from Panorama 6.0, but uses new internal dictionary format