Copy (Record function) - Revision history

JAL: Redirected page to Copy and DeepCopy (Record functions)

2012-11-08T01:02:22Z

Redirected page to Copy and DeepCopy (Record functions)

← Older revision		Revision as of 01:02, 8 November 2012
Line 1:		Line 1:
	~~{{Template:Record:Copy subtitle}}~~		#REDIRECT [[Copy and DeepCopy (Record functions)]]
	~~<var>Copy</var> makes an exact copy of a <var>Record</var> object.~~
	It is identical to the <var>Record</var> <var>[[DeepCopy (Record function)\|DeepCopy]]</var> method. <var>Record</var> objects are always copyable and "deep-copyable" (as these terms are described in [[Copying objects#The Object class copy methods\|"The Object class copy methods"]]).

	~~==Syntax==~~
	~~{{Template:Record:Copy syntax}}~~
	~~===Syntax terms===~~
	~~<table class="syntaxTable">~~
	~~<tr><th>%newRec</th>~~
	~~<td>A <var>Record</var> object created by this method that contains a copy of the method object.~~
	~~</td></tr>~~
	~~<tr><th>%rec</th>~~
	~~<td>A <var>Record</var> object variable. The variable can be null, in which case the output object will also be null.~~
	~~</td></tr>~~
	~~<tr><th>lockstrength</th>~~
	<td>A value of the <var>LockStrength</var> enumeration that is the lock strength to give to the instantiated <var>Record</var> object. Options are: <var>None</var>, <var>Share</var>, or <var>Exclusive</var>, as described in [[New (Recordset constructor)\|"New (Recordset constructor)"]]. This is an optional parameter, and it defaults to the lock strength of the method object. This parameter is only available in <var class="product">Sirius Mods</var> 7.0 and later.
	~~</td></tr>~~
	~~<tr><th><var>LoopLockStrength</var></th>~~
	~~<td>The lock strength to be used for loops on the copied <var>Record</var>. This is an optional, [[Notation conventions for methods~~#~~Named parameters\|name required]], parameter, and it defaults to the <var>LoopLockStrength</var> of the method object <var>Record</var>. See~~ [[~~Record class#LoopLockStrength for Records\|"LoopLockStrength for Records"]]. This parameter is available in <var class="product">Sirius Mods</var> 7.0 and later.~~

	~~</td></tr></table>~~
	~~==Usage notes==~~
	~~<ul>~~
	~~<li>Before <var class="product">Sirius Mods</var> 7.0,~~
	~~<var>~~Copy~~</var> did not allow setting of the target lock strength.~~
	~~So, before <var class="product">Sirius Mods</var> 7.0,~~
	~~to make a <var>Record</var> object copy with a different lock strength, the <var>New</var> or~~
	~~<var>CurrentRecord</var> (inside a <var>For</var> record loop) methods had to be used.~~

	~~<li>Since a <var>Record</var> object~~ and ~~its copy reference the same underlying~~
	~~record, there generally isn't a good reason to make a copy of a <var>Record</var>~~
	~~object — it makes more sense to just assign the reference to the~~
	~~<var>Record</var> object.~~
	~~The copy functionality for <var>Records</var> is mainly for the support of <var>~~DeepCopy~~</var>~~
	~~of <var>~~Record~~</var> objects to facilitate passing of these objects to and~~
	~~from [[Daemon class\|daemons~~]].

	~~<li>The following example illustrates the use of the <var>Copy</var> function:~~
	~~<p class="code"> %firstRec is object record in file geeks~~
	~~%currentRec is object record in file geeks~~
	~~...~~
	~~%currentRec = %firstRec:copy~~
	~~</p>~~
	~~</ul>~~

	~~==See also==~~
	~~{{Template:Record:Copy footer}}~~

JAL: /* Usage notes */

2012-11-07T00:43:22Z

Usage notes

← Older revision		Revision as of 00:43, 7 November 2012
Line 27:		Line 27:
	to make a <var>Record</var> object copy with a different lock strength, the <var>New</var> or		to make a <var>Record</var> object copy with a different lock strength, the <var>New</var> or
	<var>CurrentRecord</var> (inside a <var>For</var> record loop) methods had to be used.		<var>CurrentRecord</var> (inside a <var>For</var> record loop) methods had to be used.

	<li>Since a <var>Record</var> object and its copy reference the same underlying		<li>Since a <var>Record</var> object and its copy reference the same underlying
	record, there generally isn't a good reason to make a copy of a <var>Record</var>		record, there generally isn't a good reason to make a copy of a <var>Record</var>
	object &~~amp;~~mdash; it makes more sense to just assign the reference to the		object — it makes more sense to just assign the reference to the
	<var>Record</var> object.		<var>Record</var> object.
	The copy functionality for <var>Records</var> is mainly for the support of <var>DeepCopy</var>		The copy functionality for <var>Records</var> is mainly for the support of <var>DeepCopy</var>
	of <var>Record</var> objects to facilitate passing of these objects to and		of <var>Record</var> objects to facilitate passing of these objects to and
	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"> %firstRec is object record in file geeks		<p class="code"> %firstRec is object record in file geeks
Line 41:		Line 43:
	</p>		</p>
	</ul>		</ul>

	==See also==		==See also==
	{{Template:Record:Copy footer}}		{{Template:Record:Copy footer}}

JAL2 at 00:49, 27 April 2011

2011-04-27T00:49:11Z

← Older revision		Revision as of 00:49, 27 April 2011
Line 1:		Line 1:
	{{Template:Record:Copy subtitle}}		{{Template:Record:Copy subtitle}}
			<var>Copy</var> makes an exact copy of a <var>Record</var> object.
	<var>Copy</var> ~~is a function that~~ makes an exact copy of a <var>Record</var> object.
	It is identical to the <var>Record</var> <var>[[DeepCopy (Record function)\|DeepCopy]]</var> method. <var>Record</var> objects are always copyable and "deep-copyable" (as these terms are described in [[Copying objects#The Object class copy methods\|"The Object class copy methods"]]).		It is identical to the <var>Record</var> <var>[[DeepCopy (Record function)\|DeepCopy]]</var> method. <var>Record</var> objects are always copyable and "deep-copyable" (as these terms are described in [[Copying objects#The Object class copy methods\|"The Object class copy methods"]]).

JALWiccan: 1 revision

2011-04-20T21:50:10Z

1 revision

← Older revision	Revision as of 21:50, 20 April 2011
(No difference)

JAL2 at 21:50, 20 April 2011

2011-04-20T21:50:09Z

← Older revision		Revision as of 21:50, 20 April 2011
Line 5:		Line 5:

	==Syntax==		==Syntax==
	~~<p class="syntax">%newRec = %rec~~:Copy~~( [lockstrength] -~~		{{Template:Record:Copy syntax}}
	~~[, LoopLockStrength=lockstrength] )~~		===Syntax terms===

	~~</p>~~
	===Syntax ~~Terms~~===
	<table class="syntaxTable">		<table class="syntaxTable">
	<tr><th>%newRec</th>		<tr><th>%newRec</th>
Line 24:		Line 21:

	</td></tr></table>		</td></tr></table>
	==Usage ~~Notes~~==		==Usage notes==
	<ul>		<ul>
	<li>Before <var class="product">Sirius Mods</var> 7.0,		<li>Before <var class="product">Sirius Mods</var> 7.0,
Line 33:		Line 30:
	<li>Since a <var>Record</var> object and its copy reference the same underlying		<li>Since a <var>Record</var> object and its copy reference the same underlying
	record, there generally isn't a good reason to make a copy of a <var>Record</var>		record, there generally isn't a good reason to make a copy of a <var>Record</var>
	object — it makes more sense to just assign the reference to the		object &mdash; it makes more sense to just assign the reference to the
	<var>Record</var> object.		<var>Record</var> object.
	The copy functionality for <var>Records</var> is mainly for the support of <var>DeepCopy</var>		The copy functionality for <var>Records</var> is mainly for the support of <var>DeepCopy</var>
Line 47:		Line 44:
	==See also==		==See also==
	{{Template:Record:Copy footer}}		{{Template:Record:Copy footer}}
	~~[[Category:Record methods\|Copy function]]~~

JAL2 at 21:12, 15 April 2011

2011-04-15T21:12:14Z

← Older revision		Revision as of 21:12, 15 April 2011
Line 1:		Line 1:
	~~<span class="pageSubtitle"><section begin=dpl_desc/><section end=dpl_desc/></span>~~		{{Template:Record:Copy subtitle}}
	~~[[Category~~:Record ~~methods\|~~Copy ~~function]]~~

	<var>Copy</var> is a function that makes an exact copy of a <var>Record</var> object.		<var>Copy</var> is a function that makes an exact copy of a <var>Record</var> object.
Line 46:		Line 45:
	</p>		</p>
	</ul>		</ul>
			==See also==
			{{Template:Record:Copy footer}}
			[[Category:Record methods\|Copy function]]

JAL2: Created page with "
Copy function `Copy` is a function that makes an exact co..."

2011-04-15T20:47:08Z

Created page with "<span class="pageSubtitle"><section begin=dpl_desc/><section end=dpl_desc/></span> Copy function <var>Copy</var> is a function that makes an exact co..."

New page

<span class="pageSubtitle"><section begin=dpl_desc/><section end=dpl_desc/></span>
[[Category:Record methods|Copy function]]

<var>Copy</var> is a function that makes an exact copy of a <var>Record</var> object.
It is identical to the <var>Record</var> <var>[[DeepCopy (Record function)|DeepCopy]]</var> method. <var>Record</var> objects are always copyable and "deep-copyable" (as these terms are described in [[Copying objects#The Object class copy methods|"The Object class copy methods"]]).

==Syntax==
<p class="syntax">%newRec = %rec:Copy( [lockstrength] -
[, LoopLockStrength=lockstrength] )

</p>
===Syntax Terms===
<table class="syntaxTable">
<tr><th>%newRec</th>
<td>A <var>Record</var> object created by this method that contains a copy of the method object.
</td></tr>
<tr><th>%rec</th>
<td>A <var>Record</var> object variable. The variable can be null, in which case the output object will also be null.
</td></tr>
<tr><th>lockstrength</th>
<td>A value of the <var>LockStrength</var> enumeration that is the lock strength to give to the instantiated <var>Record</var> object. Options are: <var>None</var>, <var>Share</var>, or <var>Exclusive</var>, as described in [[New (Recordset constructor)|"New (Recordset constructor)"]]. This is an optional parameter, and it defaults to the lock strength of the method object. This parameter is only available in <var class="product">Sirius Mods</var> 7.0 and later.
</td></tr>
<tr><th><var>LoopLockStrength</var></th>
<td>The lock strength to be used for loops on the copied <var>Record</var>. This is an optional, [[Notation conventions for methods#Named parameters|name required]], parameter, and it defaults to the <var>LoopLockStrength</var> of the method object <var>Record</var>. See [[Record class#LoopLockStrength for Records|"LoopLockStrength for Records"]]. This parameter is available in <var class="product">Sirius Mods</var> 7.0 and later.

</td></tr></table>
==Usage Notes==
<ul>
<li>Before <var class="product">Sirius Mods</var> 7.0,
<var>Copy</var> did not allow setting of the target lock strength.
So, before <var class="product">Sirius Mods</var> 7.0,
to make a <var>Record</var> object copy with a different lock strength, the <var>New</var> or
<var>CurrentRecord</var> (inside a <var>For</var> record loop) methods had to be used.
<li>Since a <var>Record</var> object and its copy reference the same underlying
record, there generally isn't a good reason to make a copy of a <var>Record</var>
object — it makes more sense to just assign the reference to the
<var>Record</var> object.
The copy functionality for <var>Records</var> is mainly for the support of <var>DeepCopy</var>
of <var>Record</var> objects to facilitate passing of these objects to and
from [[Daemon class|daemons]].
<li>The following example illustrates the use of the <var>Copy</var> function:
<p class="code"> %firstRec is object record in file geeks
%currentRec is object record in file geeks
...
%currentRec = %firstRec:copy
</p>
</ul>