Added Array.Range - which allows for complex ranges of 2 arrays.

Author: photonstorm

v3/src/utils/array/Range.js

@@ -0,0 +1,116 @@
+var Shuffle = require('./Shuffle');
+var GetObjectValue = require('../object/GetObjectValue');
+
+var BuildChunk = function (a, b, qty)
+{
+    var out = [];
+
+    for (var aIndex = 0; aIndex < a.length; aIndex++)
+    {
+        for (var bIndex = 0; bIndex < b.length; bIndex++)
+        {
+            for (var i = 0; i < qty; i++)
+            {
+                out.push({ a: a[aIndex], b: b[bIndex] });
+            }
+        }
+    }
+
+    return out;
+};
+
+//  options = repeat, random, randomB, yoyo, max, qty
+
+//  Range ([a,b,c], [1,2,3]) =
+//  a1, a2, a3, b1, b2, b3, c1, c2, c3
+
+//  Range ([a,b], [1,2,3], qty = 3) =
+//  a1, a1, a1, a2, a2, a2, a3, a3, a3, b1, b1, b1, b2, b2, b2, b3, b3, b3
+
+//  Range ([a,b,c], [1,2,3], repeat x1) =
+//  a1, a2, a3, b1, b2, b3, c1, c2, c3, a1, a2, a3, b1, b2, b3, c1, c2, c3
+
+//  Range ([a,b], [1,2], repeat -1 = endless, max = 14) =
+//  Maybe if max is set then repeat goes to -1 automatically?
+//  a1, a2, b1, b2, a1, a2, b1, b2, a1, a2, b1, b2, a1, a2 (capped at 14 elements)
+
+//  Range ([a], [1,2,3,4,5], random = true) =
+//  a4, a1, a5, a2, a3
+
+//  Range ([a, b], [1,2,3], random = true) =
+//  b3, a2, a1, b1, a3, b2
+
+//  Range ([a, b, c], [1,2,3], randomB = true) =
+//  a3, a1, a2, b2, b3, b1, c1, c3, c2
+
+//  Range ([a], [1,2,3,4,5], yoyo = true) =
+//  a1, a2, a3, a4, a5, a5, a4, a3, a2, a1
+
+//  Range ([a, b], [1,2,3], yoyo = true) =
+//  a1, a2, a3, b1, b2, b3, b3, b2, b1, a3, a2, a1
+
+var Range = function (a, b, options)
+{
+    var max = GetObjectValue(options, 'max', 0);
+    var qty = GetObjectValue(options, 'qty', 1);
+    var random = GetObjectValue(options, 'random', false);
+    var randomB = GetObjectValue(options, 'randomB', false);
+    var repeat = GetObjectValue(options, 'repeat', 0);
+    var yoyo = GetObjectValue(options, 'yoyo', false);
+
+    var out = [];
+
+    if (randomB)
+    {
+        Shuffle(b);
+    }
+
+    //  Endless repeat, so limit by max
+    if (repeat === -1)
+    {
+        if (max === 0)
+        {
+            repeat = 0;
+        }
+        else
+        {
+            //  Work out how many repeats we need
+            var total = (a.length * b.length) * qty;
+
+            if (yoyo)
+            {
+                total *= 2;
+            }
+
+            repeat = Math.ceil(max / total);
+        }
+    }
+
+    for (var i = 0; i <= repeat; i++)
+    {
+        var chunk = BuildChunk(a, b, qty);
+
+        if (random)
+        {
+            Shuffle(chunk);
+        }
+
+        out = out.concat(chunk);
+
+        if (yoyo)
+        {
+            chunk.reverse();
+
+            out = out.concat(chunk);
+        }
+    }
+
+    if (max)
+    {
+        out.splice(max);
+    }
+
+    return out;
+};
+
+module.exports = Range;

v3/src/utils/array/index.js

@@ -5,6 +5,7 @@ module.exports = {
     NumberArray: require('./NumberArray'),
     NumberArrayStep: require('./NumberArrayStep'),
     QuickSelect: require('./QuickSelect'),
+    Range: require('./Range'),
     RemoveRandomElement: require('./RemoveRandomElement'),
     RotateLeft: require('./RotateLeft'),
     RotateRight: require('./RotateRight'),