Value (RandomNumberGenerator function): Difference between revisions

From m204wiki
Jump to navigation Jump to search
mNo edit summary
mNo edit summary
Line 14: Line 14:
   %num = %rand:Value([min], [max])
   %num = %rand:Value([min], [max])
===Syntax terms===
===Syntax terms===
<dl>
<table class="syntaxTable">
<dt><i>%num</i>
<tr><th><i>%num</i></th>
<dd>A numeric variable to contain
<td>A numeric variable to contain a random integer greater than or equal to ''min'' and less than or equal to ''max''. </td></tr>
a random integer greater than or equal to ''min'' and
<tr><th><i>%rand</i></th>
less than or equal to ''max''.
<td>A RandomNumberGenerator object variable. </td></tr>
<dt><i>%rand</i>
<tr><th><i>min</i></th>
<dd>A RandomNumberGenerator object variable.
<td>An optional integer that is the lower limit for the generated random number. The minimum value of this argument is the same as its default: -1,000,000,000. </td></tr>
<dt><i>min</i>
<tr><th><i>max</i></th>
<dd>An optional integer that is the lower limit for the generated
<td>An optional integer that is the upper limit for the generated random number. The maximum value of this argument is the same as its default: 1,000,000,000.</td></tr>
random number.
</table>
The minimum value
of this argument is the same as its default: -1,000,000,000.
<dt><i>max</i>
<dd>An optional integer that is the upper limit for the generated
random number.
The maximum value
of this argument is the same as its default: 1,000,000,000.
 
</dl>
===Usage Notes===
===Usage Notes===
<ul>
<ul>

Revision as of 19:49, 6 February 2011

Integer value of random number object

Value is a member of the RandomNumberGenerator class.

This method returns the integer value, within a default or explicit range, of the random number method object. Using this method is the only way to get the random number referred to by a RandomNumberGenerator object variable.

Syntax

  %num = %rand:Value([min], [max])

Syntax terms

%num A numeric variable to contain a random integer greater than or equal to min and less than or equal to max.
%rand A RandomNumberGenerator object variable.
min An optional integer that is the lower limit for the generated random number. The minimum value of this argument is the same as its default: -1,000,000,000.
max An optional integer that is the upper limit for the generated random number. The maximum value of this argument is the same as its default: 1,000,000,000.

Usage Notes

  • Since the Value method has no parameters, you can use either of the following ways if you want a fresh starting datum for each Value call:
        %num = %(randomNumberGenerator):new:value(1,10)
    
        %num = %(randomNumberGenerator):new(salt=%i):value(1,10)
    

    In the latter case, %i might be a counter that gets incremented at each New call.

.sr @h2@cct = &@h2@cc .sr @h2@cc = 65