History of rand

== Syntax ==

:int rand()

== Arguments ==

:None

== Return ==

:A random number between 0 and RAND_MAX

== Description ==

:Generates a pseudorandom number between 0 and RAND_MAX, which at the time of writing is 32767. You can use the modulo operator (%) to reduce the result to a defined range. You should also call the srand function before first calling the rand function, to ensure that the numbers do seem to be random and not predefined.

== Example ==

<code>

%ffp

// Sets each of the control values to a random

// value between 0 and 200.

ctl(0): "Red", range=( 0, 200 )

ctl(1): "Green", range=( 0, 200 )

ctl(2): "Blue", range=( 0, 200 )

onFilterStart: {

srand( clock() );

setCtlVal( 0, rand() % 200 );

setCtlVal( 1, rand() % 200 );

setCtlVal( 2, rand() % 200 );

return false;

</code>

== Also see ==

:srand, rst

== Comments ==

:Everyone can add his comments about his experiences with this function here. Tips for using it are welcome, too.