MathUtils

package com.witheringtree.utils
{
	/**
	 * Utility functions to extend the Math class.
	 */
	public class MathUtils
	{
		/**
		 * Rounds a number to a specific number of decimal places.
		 */
		public static function roundPrecision(number:Number, precision:int=0):Number
		{
			var places:Number = Math.pow(10, precision);
			return Math.round(places * number) / places;
		}
		/**
		 * Generates a random number between two number values.
		 */
		public static function randomBetween(min:Number=0, max:Number=99999999, precision:int=0):Number
		{
			return roundPrecision(Math.random() * (max - min) + min, precision);
		}
		/**
		 * Generates a random number between two number values and round to the nearest whole number.
		 */
		public static function randomBetweenRound(min:Number=0, max:Number=99999999):Number
		{
			return Math.round(randomBetween(min, max));
		}
		/**
		 * Generates a random number between two number values and rounds down to the nearest whole number.
		 */
		public static function randomBetweenFloor(min:Number=0, max:Number=99999999):Number
		{
			return Math.floor(randomBetween(min, max));
		}
		/**
		 * Generates a random number between two number values and rounds up to the nearest whole number.
		 */
		public static function randomBetweenCeil(min:Number=0, max:Number=99999999):Number
		{
			return Math.ceil(randomBetween(min, max));
		}
	}
}

MathUtils.roundPrecision(123.456);
MathUtils.randomBetween(5, 10);
MathUtils.randomBetweenRound(5, 10);
MathUtils.randomBetweenFloor(5, 10);
MathUtils.randomBetweenCeil(5, 10);