Copy and DeepCopy (Record functions) - Revision history

Dme at 17:06, 7 November 2012

2012-11-07T17:06:21Z

← Older revision		Revision as of 17:06, 7 November 2012
Line 1:		Line 1:
	{{Template:Record:Copy ~~subtitle}}~~		{{Template:Record:Copy and DeepCopy subtitle}}
	~~{{Template:Record:~~DeepCopy subtitle}}

	<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 48:		Line 47:

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

	~~[[Category:Record methods\|Copy and DeepCopy functions]]~~

JAL at 00:59, 7 November 2012

2012-11-07T00:59:22Z

← Older revision		Revision as of 00:59, 7 November 2012
Line 49:		Line 49:
	==See also==		==See also==
	{{Template:Record:DeepCopy footer}}		{{Template:Record:DeepCopy footer}}

			[[Category:Record methods\|Copy and DeepCopy functions]]

JAL at 00:57, 7 November 2012

2012-11-07T00:57:42Z

← Older revision		Revision as of 00:57, 7 November 2012
Line 1:		Line 1:
			{{Template:Record:Copy subtitle}}
	{{Template:Record:DeepCopy subtitle}}		{{Template:Record:DeepCopy subtitle}}
	<var>~~DeepCopy~~</var> ~~returns~~ an exact copy of ~~the method object. It is identical to the~~ <var>Record</var> <var>~~[[Copy (Record function)\|Copy]]~~</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"]]).
			<var>Copy</var> is a function that makes an exact copy of a <var>Record</var> object.
			<var>DeepCopy</var> performs the identical function. <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==		==Syntax==
Line 22:		Line 25:
	==Usage notes==		==Usage notes==
	<ul>		<ul>
	<li>The ~~main value~~ of <var>DeepCopy</var>		<li>Before <var class="product">Sirius Mods</var> 7.0,
	of <var>Record</var> objects is to facilitate passing of these objects to and		<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, the main value of which is to facilitate passing of these objects to and
	from [[Daemon class\|daemons]].		from [[Daemon class\|daemons]].

JAL: moved DeepCopy (Record function) to Copy and DeepCopy (Record functions)

2012-11-07T00:44:02Z

moved DeepCopy (Record function) to Copy and DeepCopy (Record functions)

← Older revision	Revision as of 00:44, 7 November 2012
(No difference)

JAL at 00:42, 7 November 2012

2012-11-07T00:42:09Z

← Older revision		Revision as of 00:42, 7 November 2012
Line 11:		Line 11:

	<tr><th>record</th>		<tr><th>record</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>		<td>A <var>Record</var> object variable. The variable can be <var>Null</var>, in which case the output object will also be <var>Null</var>.</td></tr>

	<tr><th>lockstrength</th>		<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>		<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. </td></tr>

	<tr><th><var>LoopLockStrength</var></th>		<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>		<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"]]. </td></tr>
	</table>		</table>

JAL at 00:40, 7 November 2012

2012-11-07T00:40:09Z

← Older revision		Revision as of 00:40, 7 November 2012
Line 7:		Line 7:
	===Syntax terms===		===Syntax terms===
	<table class="syntaxTable">		<table class="syntaxTable">
	<tr><th>%~~newRec~~</th>		<tr><th>%outRecord</th>
	<td>A <var>Record</var> object created by this method that contains a copy of the method object.</td></tr>		<td>A <var>Record</var> object created by this method that contains a copy of the method object.</td></tr>

	<tr><th>~~%rec~~</th>		<tr><th>record</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>		<td>A <var>Record</var> object variable. The variable can be null, in which case the output object will also be null.</td></tr>

JAL at 00:31, 7 November 2012

2012-11-07T00:31:26Z

← Older revision		Revision as of 00:31, 7 November 2012
Line 4:		Line 4:
	==Syntax==		==Syntax==
	{{Template:Record:DeepCopy syntax}}		{{Template:Record:DeepCopy syntax}}

	===Syntax terms===		===Syntax terms===
	<table class="syntaxTable">		<table class="syntaxTable">
	<tr><th>%newRec</th>		<tr><th>%newRec</th>
	<td>A <var>Record</var> object created by this method that contains a copy of the method object.		<td>A <var>Record</var> object created by this method that contains a copy of the method object.</td></tr>
	</td></tr>
	<tr><th>%rec</th>		<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>A <var>Record</var> object variable. The variable can be null, in which case the output object will also be null.</td></tr>
	</td></tr>
	<tr><th>lockstrength</th>		<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>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>
	</td></tr>
	<tr><th><var>LoopLockStrength</var></th>		<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>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>

	~~</td></tr></table>~~
	==Usage notes==		==Usage notes==
	<ul>		<ul>
Line 24:		Line 25:
	of <var>Record</var> objects is to facilitate passing of these objects to and		of <var>Record</var> objects is 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>DeepCopy</var> function:		<li>The following example illustrates the use of the <var>DeepCopy</var> function:
	<p class="code"> %firstRec is object record in file geeks		<p class="code">%firstRec is object record in file geeks
	%currentRec is object record in file geeks		%currentRec is object record in file geeks
	...		...
	%currentRec = %firstRec:deepcopy		%currentRec = %firstRec:deepcopy
	</p>		</p>
	</ul>		</ul>

JAL2 at 00:35, 27 April 2011

2011-04-27T00:35:51Z

← Older revision		Revision as of 00:35, 27 April 2011
Line 1:		Line 1:
	{{Template:Record:DeepCopy subtitle}}		{{Template:Record:DeepCopy subtitle}}
			<var>DeepCopy</var> returns an exact copy of the method object. It is identical to the <var>Record</var> <var>[[Copy (Record function)\|Copy]]</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"]]).
	<var>DeepCopy</var> ~~is a function that~~ returns an exact copy of the method ~~<var>Record</var>~~ object. It is identical to the <var>Record</var> <var>[[Copy (Record function)\|Copy]]</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==		==Syntax==

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 1:		Line 1:
	{{Template:~~Recordset~~:DeepCopy subtitle}}		{{Template:Record:DeepCopy subtitle}}

	<var>DeepCopy</var> is a function that returns an exact copy of the method <var>Record</var> object. It is identical to the <var>Record</var> <var>[[Copy (Record function)\|Copy]]</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"]]).		<var>DeepCopy</var> is a function that returns an exact copy of the method <var>Record</var> object. It is identical to the <var>Record</var> <var>[[Copy (Record function)\|Copy]]</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"]]).
Line 20:		Line 20:

	</td></tr></table>		</td></tr></table>
	==Usage ~~Notes~~==		==Usage notes==
	<ul>		<ul>
	<li>The main value of <var>DeepCopy</var>		<li>The main value of <var>DeepCopy</var>
Line 35:		Line 35:
	==See also==		==See also==
	{{Template:Record:DeepCopy footer}}		{{Template:Record:DeepCopy footer}}
	~~[[Category:Record methods\|DeepCopy function]]~~