| <html><head><META http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>4.4.4. Copy Rule</title><link href="style.css" rel="stylesheet" type="text/css"><meta content="DocBook XSL Stylesheets V1.72.0" name="generator"><link rel="start" href="index.html" title="The VIATRA2 Model Transformation Framework"><link rel="up" href="sec_ASMModelManipulationRules.html" title="4.4. Model Manipulation Rules"><link rel="prev" href="def_DeleteRule.html" title="4.4.3. Delete Rule"><link rel="next" href="def_MoveRule.html" title="4.4.5. Move Rule"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><table summary="Navigation header" width="100%"><tr><th align="center" colspan="3">4.4.4. Copy Rule</th></tr><tr><td align="left" width="20%"><a accesskey="p" href="def_DeleteRule.html">Prev</a> </td><th align="center" width="60%">4.4. Model Manipulation Rules</th><td align="right" width="20%"> <a accesskey="n" href="def_MoveRule.html">Next</a></td></tr></table><hr></div><div class="sect3" lang="en"><div class="titlepage"><div><div><h4 class="title"><a name="def_CopyRule"></a>4.4.4. Copy Rule</h4></div></div></div><div class="tip" style="margin-left: 0.5in; margin-right: 0.5in;"><table border="0" summary="Tip: Description"><tr><td valign="top" align="center" rowspan="2" width="25"><img alt="[Tip]" src="images/tip.png"></td><th align="left"><a name="def_CopyRule_Description"></a>Description</th></tr><tr><td valign="top" align="left"><p> | |
| This rule copies a subtree of the current model space to another location. | |
| </p></td></tr></table></div><div class="important" style="margin-left: 0.5in; margin-right: 0.5in;"><table border="0" summary="Important: Syntax"><tr><td valign="top" align="center" rowspan="2" width="25"><img alt="[Important]" src="images/important.png"></td><th align="left"><a name="def_CopyRule_Syntax"></a>Syntax</th></tr><tr><td valign="top" align="left"><pre class="programlisting"> | |
| CopyRuleAST ::= <span class="token">copy</span> <span class="token">(</span> CopyContentsAST <span class="token">)</span> <span class="token">;</span> | |
| CopyContentsAST ::= <a href="def_ArithmeticTerm.html" title="5.3.1. Arithmetic Term">ArithmeticTermAST</a> <span class="token">,</span> <a href="def_ArithmeticTerm.html" title="5.3.1. Arithmetic Term">ArithmeticTermAST</a> <span class="token">,</span> <a href="def_Variable.html" title="5.7.2. Variable">VariableRefAST</a> <span class="token">,</span> CopySemanticsAST | |
| CopySemanticsAST ::= <span class="token">copy_boundary_edges</span> | <span class="token">skip_boundary_edges</span> | |
| </pre><p> | |
| The first parameter (<span class="strong"><strong>source entity</strong></span>) is the root of the sub-model to be | |
| copied, and the second parameter is the <span class="strong"><strong>target container</strong></span>. | |
| </p><p> | |
| Both <span class="strong"><strong>source entity</strong></span> and <span class="strong"><strong>target container</strong></span> is an ASM | |
| <a href="def_ArithmeticTerm.html" title="5.3.1. Arithmetic Term">term</a> that evaluates to a <a href="def_ModelElementConstant.html" title="5.4.8. Model Element Constant">model element constant</a> | |
| referencing an entity. | |
| </p></td></tr></table></div><div class="note" style="margin-left: 0.5in; margin-right: 0.5in;"><table border="0" summary="Note: Semantics"><tr><td valign="top" align="center" rowspan="2" width="25"><img alt="[Note]" src="images/note.png"></td><th align="left"><a name="def_CopyRule_Semantics"></a>Semantics</th></tr><tr><td valign="top" align="left"><p> | |
| A reference to the root element of the newly created sub-model is stored in a | |
| <a href="def_Variable.html" title="5.7.2. Variable">variable</a>. | |
| </p><p> | |
| The <span class="strong"><strong>copy semantics</strong></span> | |
| <a name="N11D98" class="indexterm"></a> defines whether to copy | |
| (<code class="computeroutput">copy_boundary_edges</code>) or not to copy the edges | |
| (<code class="computeroutput">skip_boundary_edges</code>) that are going to or coming from outside | |
| the sub-model under copy. | |
| </p></td></tr></table></div><div class="highlights"><a name="def_CopyRule_Remark"></a><p><b>Remark. </b> | |
| Note that the terminology has changed compared to previous Viatra | |
| versions (<code class="computeroutput">copy_boundary_edges</code> instead of <code class="computeroutput">keep_edges</code>; | |
| <code class="computeroutput">skip_boundary_edges</code> instead of <code class="computeroutput">drop_edges</code>). | |
| </p></div><div class="highlights"><a name="def_CopyRule_DefinedIn"></a><p><b>Defined In: </b> | |
| <a href="def_ModelManipulationRule.html" title="4.4.1. Model Manipulation Rule">model manipulation rule</a> | |
| </p></div><div class="highlights"><a name="def_CopyRule_SeeAlso"></a><p><b>See Also: </b> | |
| <a href="def_MoveRule.html" title="4.4.5. Move Rule">move rule</a> | |
| </p></div></div><div class="navfooter"><hr><table summary="Navigation footer" width="100%"><tr><td align="left" width="40%"><a accesskey="p" href="def_DeleteRule.html">Prev</a> </td><td align="center" width="20%"><a accesskey="u" href="sec_ASMModelManipulationRules.html">Up</a></td><td align="right" width="40%"> <a accesskey="n" href="def_MoveRule.html">Next</a></td></tr><tr><td valign="top" align="left" width="40%">4.4.3. Delete Rule </td><td align="center" width="20%"><a accesskey="h" href="index.html">Home</a></td><td valign="top" align="right" width="40%"> 4.4.5. Move Rule</td></tr></table></div></body></html> |