Andrew Branscom: 2 revisions imported

2025-02-16T20:58:19Z

2 revisions imported

← Older revision	Revision as of 15:58, 16 February 2025
(No difference)

Andrew Branscom: 1 revision imported

2024-06-03T05:11:39Z

1 revision imported

← Older revision	Revision as of 00:11, 3 June 2024
(No difference)

sierraw>Andrew Branscom: 1 revision imported

2022-01-28T16:19:46Z

1 revision imported

New page

The '''random''' command generates a random number within a specified range.

== Syntax ==

random([[number|byt]] LOWER, [[number|byt]] UPPER, [[variable|var]] vRESULT);

== Remarks ==

The value of variable '''vRESULT''' is set to a pseudo random number between '''LOWER''' and '''UPPER''' inclusive. The algorithm that AGI uses to generate random numbers is:

<syntaxhighlight lang="agi">if (rndseed == 0)
{
rndseed = current_clock_count; [ use internal clock count as starting seed
}
rndseed = (rndseed * 0x7C4D) mod 0xFFFF + 1;
vRESULT = LOWER + rndseed mod (UPPER - LOWER + 1);</syntaxhighlight>

== Possible Errors ==

To work correctly, '''UPPER''' must be greater than or equal to '''LOWER'''. If If '''LOWER''' is greater than '''UPPER''', then the returned value will be in the range 0 - 255. If '''LOWER''' is exactly = '''UPPER''' + 1, it causes a divide by zero situation, which will [[crash AGI]].

== Example ==

<div class="CodeBlockHeader">Code:</div>
<syntaxhighlight lang="agi">
random(0, 10, v50);
print("%v50 is greater than or equal to 0 "
"AND less than or equal to 10");
</syntaxhighlight>

== Technical Information ==

{| border="1" cellpadding="2"
| style="background-color: #efefef" width="200" | '''Required Interpreter Version:'''
| width="175" | Available in all AGI versions.
|-
| style="background-color: #efefef" | '''Byte-Code Value:'''
| 130 (0x82 hex)
|}

== See Also ==

[[Mathematical Commands]]<br />
[[Category:Commands]]<br />

Random - Revision history

Andrew Branscom: 2 revisions imported

Andrew Branscom: 1 revision imported

sierraw>Andrew Branscom: 1 revision imported