====== Algorithms ======
Common algorithms.

===== Functions =====

==== md4 ====
Calculates a md4 hash.

=== Syntax ===
<code javascript>
Algorithms.md4(data);
</code>

=== Arguments ===
  - data - (string) the input data

=== Returns ===
  * (string) the calculated hash in hexadecimal form

=== Examples ===
<code javascript>
var result = Algorithms.md4("some data");
//result == "a19fcbc49cf40331e8b7873f4700e1fd"
</code>

==== md5 ====
Calculates a md5 hash.

=== Syntax ===
<code javascript>
Algorithms.md5(data);
</code>

=== Arguments ===
  - data - (string) the input data

=== Returns ===
  * (string) the calculated hash in hexadecimal form

=== Examples ===
<code javascript>
var result = Algorithms.md5("some data");
//result == "1e50210a0202497fb79bc38b6ade6c34"
</code>

==== sha1 ====
Calculates a sha1 hash.

=== Syntax ===
<code javascript>
Algorithms.sha1(data);
</code>

=== Arguments ===
  - data - (string) the input data

=== Returns ===
  * (string) the calculated hash in hexadecimal form

=== Examples ===
<code javascript>
var result = Algorithms.sha1("some data");
//result == "baf34551fecb48acc3da868eb85e1b6dac9de356"
</code>

==== setRandomSeed ====
Set the seed for the pseudorandom number generation.

=== Syntax ===
<code javascript>
Algorithms.setRandomSeed(seed);
</code>

=== Arguments ===
  - seed - (int) the seed for the pseudorandom number generation

=== Returns ===
  * (null) nothing

=== Examples ===
<code javascript>
Algorithms.setRandomSeed(42);
</code>

==== randomMax ====
Returns the maximum integer value returned by [[#randominteger|randomInteger]].

=== Syntax ===
<code javascript>
Algorithms.randomMax();
</code>

=== Returns ===
  * (int)  the maximum integer value returned by [[#randominteger|randomInteger]]

=== Examples ===
<code javascript>
var result = Algorithms.randomMax();
</code>

==== randomInteger ====
Returns a random number between 0 and [[#randommax|randomMax]] (inclusive) or between **min** and **max** (inclusive).

=== Syntax ===
<code javascript>
Algorithms.randomInteger();
</code>
<code javascript>
Algorithms.randomInteger(min, max);
</code>

=== Arguments ===
  - min - (int) the minimum value
  - max - (int) the maximum value

=== Returns ===
  * (int) a random number between 0 and [[#randommax|randomMax()]] (inclusive) or between **min** and **max** (inclusive)

=== Examples ===
<code javascript>
var result = Algorithms.randomInteger();
</code>
<code javascript>
var result = Algorithms.randomInteger(0, 3);
</code>

==== randomFloat ====
Return a random decimal (floating) number between **min** and **max** (inclusive).

=== Syntax ===
<code javascript>
Algorithms.randomFloat(min, max);
</code>

=== Arguments ===
  - min - (float) the minimum value
  - max - (float) the maximum value

=== Returns ===
  * (float) a random decimal (floating) number between **min** and **max** (inclusive)

=== Examples ===
<code javascript>
var result = Algorithms.randomFloat(0.15, 3);
</code>

==== randomString ====
Generates a random string.

=== Syntax ===
<code javascript>
Algorithms.randomString({object});
</code>

=== Arguments ===
  - object
    * characters - (string) character list to choose from (default value: "abcdefghijklmnopqrstuvwxyz0123456789")
    * minLength - (int) minimal length (default value: 5)
    * maxLength - (int) maximal length (default value: 15)

=== Returns ===
  * (string) a random string

=== Exceptions ===
  * (ParameterCountError) incorrect parameter count

=== Examples ===
<code javascript>
var result1 = Algorithms.randomString();
var result2 = Algorithms.randomString({
	characters: "abcdef"
});
var result3 = Algorithms.randomString({
	characters: "abcdef",
	minLength: 10,
	maxLength: 20
});
</code>