www.aleph1.co.uk Git - yaffs-website/blob - node_modules/grunt-legacy-util/node_modules/lodash/random.js

   1 var baseRandom = require('./_baseRandom'),
   2     isIterateeCall = require('./_isIterateeCall'),
   3     toNumber = require('./toNumber');
   4
   5 /** Built-in method references without a dependency on `root`. */
   6 var freeParseFloat = parseFloat;
   7
   8 /* Built-in method references for those with the same name as other `lodash` methods. */
   9 var nativeMin = Math.min,
  10     nativeRandom = Math.random;
  11
  12 /**
  13  * Produces a random number between the inclusive `lower` and `upper` bounds.
  14  * If only one argument is provided a number between `0` and the given number
  15  * is returned. If `floating` is `true`, or either `lower` or `upper` are floats,
  16  * a floating-point number is returned instead of an integer.
  17  *
  18  * **Note:** JavaScript follows the IEEE-754 standard for resolving
  19  * floating-point values which can produce unexpected results.
  20  *
  21  * @static
  22  * @memberOf _
  23  * @category Number
  24  * @param {number} [lower=0] The lower bound.
  25  * @param {number} [upper=1] The upper bound.
  26  * @param {boolean} [floating] Specify returning a floating-point number.
  27  * @returns {number} Returns the random number.
  28  * @example
  29  *
  30  * _.random(0, 5);
  31  * // => an integer between 0 and 5
  32  *
  33  * _.random(5);
  34  * // => also an integer between 0 and 5
  35  *
  36  * _.random(5, true);
  37  * // => a floating-point number between 0 and 5
  38  *
  39  * _.random(1.2, 5.2);
  40  * // => a floating-point number between 1.2 and 5.2
  41  */
  42 function random(lower, upper, floating) {
  43   if (floating && typeof floating != 'boolean' && isIterateeCall(lower, upper, floating)) {
  44     upper = floating = undefined;
  45   }
  46   if (floating === undefined) {
  47     if (typeof upper == 'boolean') {
  48       floating = upper;
  49       upper = undefined;
  50     }
  51     else if (typeof lower == 'boolean') {
  52       floating = lower;
  53       lower = undefined;
  54     }
  55   }
  56   if (lower === undefined && upper === undefined) {
  57     lower = 0;
  58     upper = 1;
  59   }
  60   else {
  61     lower = toNumber(lower) || 0;
  62     if (upper === undefined) {
  63       upper = lower;
  64       lower = 0;
  65     } else {
  66       upper = toNumber(upper) || 0;
  67     }
  68   }
  69   if (lower > upper) {
  70     var temp = lower;
  71     lower = upper;
  72     upper = temp;
  73   }
  74   if (floating || lower % 1 || upper % 1) {
  75     var rand = nativeRandom();
  76     return nativeMin(lower + (rand * (upper - lower + freeParseFloat('1e-' + ((rand + '').length - 1)))), upper);
  77   }
  78   return baseRandom(lower, upper);
  79 }
  80
  81 module.exports = random;