UpdateSeed (RandomNumberGenerator subroutine) - Revision history

JAL at 21:35, 6 November 2012

2012-11-06T21:35:25Z

← Older revision		Revision as of 21:35, 6 November 2012
Line 2:		Line 2:

	This method sets a random number object to the number		This method sets a random number object to the number
	that would be created by the [[New (RandomNumberGenerator constructor)\|New ~~constructor~~]]		that would be created by the <var>[[New (RandomNumberGenerator constructor)\|New]]</var> <var>Constructor</var>
	with the given Seed and Salt specifications.		with the given <var>Seed</var> and <var>Salt</var> parameter specifications.

	==Syntax==		==Syntax==
	{{Template:RandomNumberGenerator:UpdateSeed syntax}}		{{Template:RandomNumberGenerator:UpdateSeed syntax}}

	===Syntax terms===		===Syntax terms===
	<table class="syntaxTable">		<table class="syntaxTable">
	<tr><th>randomNumberGenerator</th>		<tr><th>randomNumberGenerator</th>
	<td>A <var>RandomNumberGenerator</var> object variable. </td></tr>		<td>A <var>RandomNumberGenerator</var> object variable. </td></tr>

	<tr><th><var>Seed</var></th>		<tr><th><var>Seed</var></th>
	<td>An optional, name required, argument that lets you specify a "seed" for the random number generator. If you provide no seed, the method generates a new, "random," starting value for the random number generator.		<td>An optional, [[Notation conventions for methods#Named parameters\|name required]], string argument that lets you specify a "seed" for the random number generator. If you provide no seed, the method generates a new, "random," starting value for the random number generator.</td></tr>

	~~<var>Seed</var> is a string. </td></tr>~~
	<tr><th><var>Salt</var></th>		<tr><th><var>Salt</var></th>
	<td>An optional, name required, argument that lets you specify a "salt" for the random number generator. A salt is additional data to be used (along with the explicit or default seed) to improve the randomness of the random generator's initial value.		<td>An optional, name required, string argument that lets you specify a "salt" for the random number generator. A salt is additional data to be used (along with the explicit or default seed) to improve the randomness of the random generator's initial value.
			</td></tr>
	~~<var>salt</var> is a string.~~</td></tr>

	</table>		</table>

	==Examples==		==Examples==
			In the following request, calling <var>UpdateSeed</var> enables the production of a second
	In the following request, calling ~~updateSeed~~ enables the production of a second		series of three values of <code>%rand</code> that matches the initial series of three
	series of three values of %rand that matches the initial series of three		values of <code>%rand</code>:
	values of %rand:
	<p class="code">begin		<p class="code">begin
	%i is float		%i is float
Line 53:		Line 52:
	If instead the random number is created with a salt,		If instead the random number is created with a salt,
	as in the following fragment,		as in the following fragment,
	an ~~updateSeed~~ call using the salt produces a unique series of		an <var>UpdateSeed</var> call using the salt produces a unique series of
	three values (salted numbers are not reproducible):		three values (salted numbers are not reproducible):
	<p class="code">...		<p class="code">...

DmeWiccan: 1 revision

2011-04-12T22:32:58Z

1 revision

← Older revision	Revision as of 22:32, 12 April 2011
(No difference)

Dme: /* Syntax terms */

2011-04-12T22:32:58Z

Syntax terms

← Older revision		Revision as of 22:32, 12 April 2011
Line 10:		Line 10:
	<tr><th>randomNumberGenerator</th>		<tr><th>randomNumberGenerator</th>
	<td>A <var>RandomNumberGenerator</var> object variable. </td></tr>		<td>A <var>RandomNumberGenerator</var> object variable. </td></tr>
	<tr><th>Seed</th>		<tr><th><var>Seed</var></th>
	<td>An optional, name required, argument that lets you specify a "seed" for the random number generator. If you provide no seed, the method generates a new, "random," starting value for the random number generator.		<td>An optional, name required, argument that lets you specify a "seed" for the random number generator. If you provide no seed, the method generates a new, "random," starting value for the random number generator.

	<var>Seed</var> is a string. </td></tr>		<var>Seed</var> is a string. </td></tr>
	<tr><th>Salt</th>		<tr><th><var>Salt</var></th>
	<td>An optional, name required, argument that lets you specify a "salt" for the random number generator. A salt is additional data to be used (along with the explicit or default seed) to improve the randomness of the random generator's initial value.		<td>An optional, name required, argument that lets you specify a "salt" for the random number generator. A salt is additional data to be used (along with the explicit or default seed) to improve the randomness of the random generator's initial value.

Dme: /* Syntax terms */

2011-02-17T12:16:13Z

Syntax terms

New page

{{Template:RandomNumberGenerator:UpdateSeed subtitle}}

This method sets a random number object to the number
that would be created by the [[New (RandomNumberGenerator constructor)|New constructor]]
with the given Seed and Salt specifications.
==Syntax==
{{Template:RandomNumberGenerator:UpdateSeed syntax}}
===Syntax terms===
<table class="syntaxTable">
<tr><th>randomNumberGenerator</th>
<td>A <var>RandomNumberGenerator</var> object variable. </td></tr>
<tr><th>Seed</th>
<td>An optional, name required, argument that lets you specify a "seed" for the random number generator. If you provide no seed, the method generates a new, "random," starting value for the random number generator.

<var>Seed</var> is a string. </td></tr>
<tr><th>Salt</th>
<td>An optional, name required, argument that lets you specify a "salt" for the random number generator. A salt is additional data to be used (along with the explicit or default seed) to improve the randomness of the random generator's initial value.

<var>salt</var> is a string.</td></tr>

</table>

==Examples==

In the following request, calling updateSeed enables the production of a second
series of three values of %rand that matches the initial series of three
values of %rand:
<p class="code">begin
%i is float
%rand is object RandomNumberGenerator

%rand = new(seed='help')
for %i from 1 to 3
printtext {~} = {%rand:value}
end for

%rand:updateSeed(seed='help')
for %i from 1 to 3
printtext {~} = {%rand:value}
end for
end
</p>

The result is:
<p class="output">%rand:value = 816969049
%rand:value = -148817379
%rand:value = 895846046
%rand:value = 816969049
%rand:value = -148817379
%rand:value = 895846046
</p>

If instead the random number is created with a salt,
as in the following fragment,
an updateSeed call using the salt produces a unique series of
three values (salted numbers are not reproducible):
<p class="code">...
%rand = new(salt='iou')
for %i from 1 to 3
printtext {~} = {%rand:value}
end for

%rand:updateSeed(salt='iou')
for %i from 1 to 3
printtext {~} = {%rand:value}
end for
</p>

A sample result is:
<p class="output">%rand:value = 320947512
%rand:value = 535019615
%rand:value = -526589924
%rand:value = 387949238
%rand:value = 413468100
%rand:value = -807607538
</p>

==See also==
{{Template:RandomNumberGenerator:UpdateSeed footer}}

Wiccan: 1 revision

2011-02-08T18:19:55Z

1 revision

← Older revision	Revision as of 18:19, 8 February 2011
(No difference)

Dme: /* Examples */

2011-02-08T18:19:54Z

Examples

← Older revision		Revision as of 18:19, 8 February 2011
Line 12:		Line 12:
	<tr><th>Seed=seed</th>		<tr><th>Seed=seed</th>
	<td>An optional, name required, argument that lets you specify a "seed" for the random number generator. If you provide no seed, the method generates a new, "random," starting value for the random number generator.		<td>An optional, name required, argument that lets you specify a "seed" for the random number generator. If you provide no seed, the method generates a new, "random," starting value for the random number generator.
	~~<p class="code">~~''seed'' is a string or a longstring. </td></tr>
	~~</p~~>		''seed'' is a string or a longstring. </td></tr>
	<tr><th>Salt=salt</th>		<tr><th>Salt=salt</th>
	<td>An optional, name required, argument that lets you specify a "salt" for the random number generator. A salt is additional data to be used (along with the explicit or default seed) to improve the randomness of the random generator's initial value.		<td>An optional, name required, argument that lets you specify a "salt" for the random number generator. A salt is additional data to be used (along with the explicit or default seed) to improve the randomness of the random generator's initial value.
	~~<p class="code">~~''salt'' is a string or a longstring.</td></tr>
	~~</p>~~		''salt'' is a string or a longstring.</td></tr>

	</table>		</table>
	==Examples==		==Examples==

Dme: /* Examples */

2011-02-06T21:58:33Z

Examples

← Older revision		Revision as of 21:58, 6 February 2011
Line 26:		Line 26:
	<p class="code">begin		<p class="code">begin
	%i is float		%i is float
	%rand is object ~~<var>~~RandomNumberGenerator~~</var>~~		%rand is object RandomNumberGenerator

	%rand = new(seed='help')		%rand = new(seed='help')
Line 73:		Line 73:
	%rand:value = -807607538		%rand:value = -807607538
	</p>		</p>

	==See also==		==See also==
	{{Template:RandomNumberGenerator:UpdateSeed footer}}		{{Template:RandomNumberGenerator:UpdateSeed footer}}

Wiccan: 1 revision

2011-02-06T21:50:09Z

1 revision

← Older revision	Revision as of 21:50, 6 February 2011
(No difference)

Wiccan: 1 revision

2011-02-06T21:50:08Z

1 revision

← Older revision		Revision as of 21:50, 6 February 2011
Line 9:		Line 9:
	<table class="syntaxTable">		<table class="syntaxTable">
	<tr><th>%rand</th>		<tr><th>%rand</th>
	<td>A RandomNumberGenerator object variable. </td></tr>		<td>A <var>RandomNumberGenerator</var> object variable. </td></tr>
	<tr><th>Seed=seed</th>		<tr><th>Seed=seed</th>
	<td>An optional, name required, argument that lets you specify a "seed" for the random number generator. If you provide no seed, the method generates a new, "random," starting value for the random number generator.		<td>An optional, name required, argument that lets you specify a "seed" for the random number generator. If you provide no seed, the method generates a new, "random," starting value for the random number generator.
Line 26:		Line 26:
	<p class="code">begin		<p class="code">begin
	%i is float		%i is float
	%rand is object RandomNumberGenerator		%rand is object <var>RandomNumberGenerator</var>

	%rand = new(seed='help')		%rand = new(seed='help')

Wiccan: 1 revision

2011-02-06T21:49:00Z

1 revision

← Older revision	Revision as of 21:49, 6 February 2011
(No difference)