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>
<tt ng:non-bindable>
angular.Object.copy(source, destination);
</tt>
<h3>Parameters</h3>
<ul>
    <li><tt>source</tt> –
      <tt>&#123;*&#125;</tt>
      <tt></tt>
      – The source to be used to make a copy.
                  Can be any type including primitives, <code>null</code> and <code>undefined</code>.</li>
    <li><tt>destination</tt> –
      <tt>&#123;(Object|Array)=&#125;</tt>
      <tt></tt>
      – Optional destination into which the source is copied.</li>
  </ul>
<h3>Returns</h3>
<tt>&#123;*&#125;</tt> 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:scenario></doc:scenario>
</doc:example>