copyparticaldictionary
copyparticaldictionary
SOURCEDICTIONARY
,
TARGETDICTIONARY
,
KEY

The copyparticaldictionary statement builds a new dictionary and initializes it with values from an existing dictionary.

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 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 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):

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

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

See Also

- appenddictionaryvalue
- changedictionaryname
- changedictionaryvalues(
- copypartialdictionary(
- deletedictionaryvalue(
- dictionaryvalueexists(
- dumpdictionary(
- dumpdictionaryquoted(
- getdictionarykey(
- getdictionaryvalue(
- info("timerinfo")
- initializedictionary
- initializedictionary(
- initializedictionaryvalue(
- listdictionarykeys(
- mergedictionaries(
- renamedictionarykey(
- timerinfo(

History

Version | Status | Notes
1.0 | Updated | Carried over from Panorama 6.0, but uses new internal dictionary format