• *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

PROPERTY_RECURSE_ASSIGN Function

Syntax

Arguments

destination

The name of the destination dot variable.

source

The name of the source dot variable.

Description

Recursive property assignment (for propagating properties instead of referencing them).

Discussion

PROPERTY_RECURSE_ASSIGN() assigns the sub-elements of one "Dot" variable to another. If you set one dot variable to another (e.g. dot_var1 = dot_var2), the sub-elements of the assigned dot variable simply point to the original dot variable's sub-element. However, if you use the PROPERTY_RECURSE_assign() function, the assigned dot variable has its own copy of the sub-elements.

Example

Type the following in the Interactive window:

Family.lastname = "Smith"
Family.father = "John"
Family.mother = "Irene"
Family.children.child1 = "Tim"
Family.children.child2 = "Lara"
b.lastname = ""
property_recurse_assign(b, family)
c = family
? b.lastname -> "Smith"
? c.lastname -> "Smith"
Family.lastname = "Jones"
? Family.lastname -> "Jones"
? b.lastname -> "Smith" (because "B" is its own variable. It does not point to the "Family" dot variable.)
? c.lastname -> "Jones" (because "C" simply points to the "Family" dot variable.)

See Also

• Variable Functions and Methods