/**
 * Class: JSL.number
 * This holds the number based operations. I am not sure why I have included this in the main code base - it don't have a lot of practical uses. 
 * Arguments: number - The initial number - the original value
 */
(function() {
	function _number_init(number) {
		this.number = number;
		return this;
	}
	
	_number_init.prototype = {
		/**
		 * Calls the function provided as the argument the specified number of times. It also
		 *	gives the number of the current run as an argument to the user function.
		 * Example:
		 *	JSL.number(5).times(function(i) { alert("Run #"+i); }); //Executes the function 5 times
		 */
		"times":function(func) {
			var func = JSL._makeFunc(func,"i");
			for(var i=0; i<this.number; i++) {
				func.call(this, i);
			}
		},
		
		/**
		 * Calls the given function with the value of the current number as an argument.
		 * Arguments: upper_limit - The upper limit of the loop - the function will be executed while initial_number <= current_number <= upper_limit
		 * Example:
		 *	//Calls the function 8 times - the alerts will be 
		 *	//	Run #2, Run #3, Run#4 ... Run #9, Run#10
		 *	JSL.number(2).upto(10, function(i) {alert("Run #"+i);}); 
		 */
		"upto":function(upper_limit, func) {
			var func = JSL._makeFunc(func,"i");
			for(var i=this.number; i<=upper_limit; i++) {
				func.call(this, i);
			}
		},
		
		/**
		 * Function that could be used to round a number to a given decimal points. Returns the answer.
		 * Taken from http://www.openjs.com/scripts/maths/rounding_numbers.php
		 * Arguments :  decimal_points - The number of decimal points that should appear in the result
		 * Example: JSL.number(23.2833).round(2); //returns 23.28
		 */
		"round": function(decimal_points) {
			if(!decimal_points) return Math.round(this.number);
			if(this.number == 0) {
				var decimals = "";
				for(var i=0;i<decimal_points;i++) decimals += "0";
				return "0."+decimals;
			}
		
			var exponent = Math.pow(10, decimal_points);
			var num = Math.round((this.number * exponent)).toString();
			return Number(num.slice(0,-1*decimal_points) + "." + num.slice(-1*decimal_points));
		},
		
		/**
		 * Returns a random number between the number given as the argument.
		 * Arguments: upper_limit - The maximum value that can be returned by the function. Defaults to 100
		 * 			  lower_limit - The minimum value. Defaults to 0
		 * Example: JSL.number().random(5); // returns a number between 0 and 5.
		 * 			JSL.number().random(25, 20); // returns a number between 20 and 25.
		 */
		"random": function(upper_limit, lower_limit) {
			if(typeof upper_limit == "undefined") upper_limit = 100;
			if(typeof lower_limit == "undefined") lower_limit = 0;
			return Math.floor(Math.random() * (upper_limit - lower_limit + 1)) + lower_limit;
		}
	}
	
	window.JSL["number"] = function(number) {
		return new _number_init(number);
	}
})();