Merge pull request #4251 from JackStouffer/interleave

Add informative example to roundRobin

std/range/package.d

@@ -1654,6 +1654,34 @@ if (Rs.length > 1 && allSatisfy!(isInputRange, staticMap!(Unqual, Rs)))
     assert(equal(r, [ 1, 10, 2, 20, 3, 30, 40 ]));
 }
 
+/**
+ * roundRobin can be used to create "interleave" functionality which inserts
+ * an element between each element in a range.
+ */
+unittest
+{
+    import std.algorithm.comparison : equal;
+
+    auto interleave(R, E)(R range, E element) if (isInputRange!R)
+    {
+        static if (hasLength!R)
+        {
+            immutable len = range.length;
+        }
+        else
+        {
+            immutable len = range.walkLength;
+        }
+
+        return roundRobin(
+            range,
+            element.repeat(len - 1)
+        );
+    }
+
+    assert(interleave([1, 2, 3], 0).equal([1, 0, 2, 0, 3]));
+}
+
 /**
 Iterates a random-access range starting from a given point and
 progressively extending left and right from that point. If no initial