• *PROPERTY_DIFFERENCE Function
• *summary_groups_enum Function
• *variable_delegate Function
• *variable_name_normalize Function
• *variable_parent_restore Function
• *variable_parent_set Function
• *variable_to_script Function
• a5_cnvrt_dot_vars Function
• a5_copy_ask_vars Function
• a5_defaultvalue_get Function
• a5_defaultvalue_set Function
• A5_DEFINE_GLOBAL_VARS Function
• A5_DELETE_SETTINGS Function
• a5_dim_ask_vars Function
• A5_EXPORT_PROPS_TO_CMDS Function
• a5_extract_ask_vars Function
• a5_get_var_names Function
• a5_is_var_name_valid Function
• a5_javascript_property_to_attribute Function
• a5_list_user_vars Function
• A5_LOAD_SETTINGS Function
• a5_prompt_for_ask_vars Function
• a5_property_to_arguments Function
• a5_property_to_attribute Function
• A5_SAVE_SETTINGS Function
• a5w_resolvevariablesinoverridesettings Function
• all_variables Function
• CANCEL Function
• getenvironmentvariable Function
• GLOBAL_VARIABLES Function
• LOCAL_VARIABLES Function
• Merge_Variable_Frames Function
• PROP_VALID Function
• PROPERTIES_ENUM Function
• PROPERTY_FROM_STRING Function
• PROPERTY_RECURSE_ASSIGN Function
• PROPERTY_TO_STRING Function
• propertyfromquerystring Function
• REPLACE_VARIABLES_IN_STRING Function
• SESSION_VARIABLES Function
• SHOWVAR Function
• submit_let Function
• variable_exists Function
• variable_name_normalize Function

Merge_Variable_Frames Function

Syntax

Arguments

dominantFrame

A dot variable containing one or more sub-variables. If the otherFrame contains a variable of the same name, the variable value from the dominantFrame is used.

otherFrame

A dot variable containing one or more sub-variables.

Description

Merges the variables from one variable frame into another variable frame.

Discussion

Merges the variables in two different variable frames (i.e. 'dot' variables) into a single variable frame.

Example

'Assume that you have two dot variables (v1, and v2)  defined as follows:
dim v1 as p 
v1.name = "John"
dim v1.cities1 as c 
v1.age = 23
dim v1.arr3 as p 
v1.arr1.item1 = "Row1 - item1"
v1.arr1.item2 = "Row1 - item2"


dim v2 as p 
v2.name = "Harry"
v2.occupation = "Lawyer"
dim v2.cities3 as c 
v2.cities1 = "Boston"
v2.cities2 = "New York"
v2.cities3 = "Chicago"

'Now merge these dot variables, with V2 as the 'dominant' frame
merge_variable_frames(v2,v1)

'Now use the *variable_to_script() function to see what the resulting variable frame looks like:
?variable_to_script(v2)
DIM age as N = 23
DIM arr3 as P
DIM arr1.item1 as C = "Row1 - item1"
DIM arr1.item2 as C = "Row1 - item2"
DIM name as C = "Harry"
DIM occupation as C = "Lawyer"
DIM cities3 as C
cities1 = "Boston"
cities2 = "New York"
cities3 = "Chicago"