angular.Object.copy.html

<h1>angular.Object.copy</h1>
<fieldset class="workInProgress"><legend>Work in Progress</legend>
This page is currently being revised. It might be incomplete or contain inaccuracies.</fieldset>
<h2>Description</h2>
<p>Creates a deep copy of <code>source</code>.</p>

<p>If <code>destination</code> is not provided and <code>source</code> is an object or an array, a copy is created &amp;
returned, otherwise the <code>source</code> is returned.</p>

<p>If <code>destination</code> is provided, all of its properties will be deleted.</p>

<p>If <code>source</code> is an object or an array, all of its members will be copied into the <code>destination</code>
object.</p>

<p>Note: this function is used to augment the Object type in angular expressions. See
<a href="#!angular.Object"><code>angular.Object</code></a> for more info.</p><h2>Usage</h2>
<div ng:non-bindable=""><pre class="brush: js; html-script: true;">angular.Object.copy(source, destination);</pre>
</div>
<h3>Parameters</h3>
<ul class="parameters"><li><code ng:non-bindable="">source – {*} – </code>
The source to be used to make a copy.
                  Can be any type including primitives, <code>null</code> and <code>undefined</code>.</li>
<li><code ng:non-bindable="">destination<i>(optional)</i> – {(Object|Array)} – </code>
Optional destination into which the source is copied.</li>
</ul>
<h3>Returns</h3>
<code ng:non-bindable="">*</code>
– The copy or updated <code>destination</code> if <code>destination</code> was specified.<h2>Example</h2>
<doc:example><doc:source>Salutation: &lt;input type="text" name="master.salutation" value="Hello" /&gt;&lt;br/&gt;
Name: &lt;input type="text" name="master.name" value="world"/&gt;&lt;br/&gt;
&lt;button ng:click="form = master.$copy()"&gt;copy&lt;/button&gt;
&lt;hr/&gt;

Master is &lt;span ng:hide="master.$equals(form)"&gt;NOT&lt;/span&gt; same as form.

&lt;pre&gt;master={{master}}&lt;/pre&gt;
&lt;pre&gt;form={{form}}&lt;/pre&gt;</doc:source>
</doc:example>