Copy (SortedRecordset function): Difference between revisions
Jump to navigation
Jump to search
m (Created page with "<span class="pageSubtitle"><section begin=dpl_desc/><section end=dpl_desc/></span> Copy and DeepCopy functions <p> <var>Copy</var> and <var>D...") |
m (→Usage notes) |
||
| (4 intermediate revisions by 2 users not shown) | |||
| Line 1: | Line 1: | ||
{{Template:SortedRecordset:Copy subtitle}} | |||
This function makes a copy of a <var>SortedRecordset</var> object. | |||
The <var>[[DeepCopy (SortedRecordset function)|DeepCopy]]</var> function is identical to <var>Copy</var>, but it flags the <var>SortedRecordset</var> class as "deep-copyable" (as these terms are described in | |||
The <var>DeepCopy</var> function | |||
class as "deep-copyable" (as these terms are described in | |||
[[Copying objects#The Object class copy methods|"The Object class copy methods"]]). | [[Copying objects#The Object class copy methods|"The Object class copy methods"]]). | ||
==Syntax== | ==Syntax== | ||
{{Template:SortedRecordset:Copy syntax}} | |||
===Syntax terms=== | ===Syntax terms=== | ||
<table class="syntaxTable"> | <table class="syntaxTable"> | ||
<tr><th>% | <tr><th>%outSortedRecordset</th> | ||
<td>A <var>SortedRecordset</var> object created by this method that contains a copy of the method object. | <td>A <var>SortedRecordset</var> object created by this method that contains a copy of the method object. | ||
</td></tr> | </td></tr> | ||
<tr><th> | <tr><th>sortedRecordset</th> | ||
<td>A <var>SortedRecordset</var> object variable. The variable can be null, in which case the output object will also be null. | <td>A <var>SortedRecordset</var> object variable. The variable can be null, in which case the output object will also be null. | ||
</td></tr></table> | </td></tr></table> | ||
==Usage | ==Usage notes== | ||
<ul> | <ul> | ||
<li>Since a <var>SortedRecordset</var> object can't be modified once it's created, | <li>Since a <var>SortedRecordset</var> object can't be modified once it's created, | ||
| Line 34: | Line 24: | ||
from [[Daemon class|daemons]]. | from [[Daemon class|daemons]]. | ||
<li>The following example illustrates the use of the <var>Copy</var> function: | <li>The following example illustrates the use of the <var>Copy</var> function: | ||
<p class="code"> %sorted is object sortedRecordset in file geeks | <p class="code">%sorted is object sortedRecordset in file geeks | ||
%sortedCopy is object sortedRecordset in file geeks | |||
... | |||
%sortedCopy = %sorted:copy | |||
</p> | </p> | ||
</ul> | </ul> | ||
==See also== | |||
{{Template:SortedRecordset:Copy footer}} | |||
Latest revision as of 21:34, 9 November 2012
Copy this SortedRecordset object (SortedRecordset class)
This function makes a copy of a SortedRecordset object.
The DeepCopy function is identical to Copy, but it flags the SortedRecordset class as "deep-copyable" (as these terms are described in
"The Object class copy methods").
Syntax
%outSortedRecordset = sortedRecordset:Copy
Syntax terms
| %outSortedRecordset | A SortedRecordset object created by this method that contains a copy of the method object. |
|---|---|
| sortedRecordset | A SortedRecordset object variable. The variable can be null, in which case the output object will also be null. |
Usage notes
- Since a SortedRecordset object can't be modified once it's created, there generally isn't a good reason to make a copy of a SortedRecordset object — it makes more sense to just assign the reference to the SortedRecordset object. The copy functionality for SortedRecordsets is mainly there to support DeepCopy of SortedRecordset objects to facilitate passing of these objects to and from daemons.
- The following example illustrates the use of the Copy function:
%sorted is object sortedRecordset in file geeks %sortedCopy is object sortedRecordset in file geeks ... %sortedCopy = %sorted:copy