Generates a pseudo-random number.

A pseudo-random decimal number, in the range 0 - 1.

Mathematical functions, Security functions

Rand([algorithm])

ColdFusion MX 7: Added the algorithm parameter.

Randomize, RandRange

Call the Randomize function before calling this function to seed the random number generator. Seeding the generator ensures that the Rand function always generates the same sequence of pseudo-random numbers. This behavior is useful if you must reproduce a pattern consistently.

ColdFusion MX 7 uses the Java Cryptography Extension (JCE) and installs a Sun Java 1.4.2 runtime that includes the Sun JCE default security provider. This provider includes the algorithms listed in the Parameters section (except the default algorithm). The JCE framework includes facilities for using other provider implementations; however, Macromedia cannot provide technical support for third-party security providers.

The following example uses the SHA1PRNG algorithm to generate a single random number:

<h3>Rand Example</h3>
<cfoutput>
   <p>Rand("SHA1PRNG") returned: #Rand("SHA1PRNG")#</p>
   <p><A HREF = "#CGI.SCRIPT_NAME#">Try again</A>
</cfoutput>