feat(transducers): add normRange() iterator

thi-ng · May 10, 2018 · 55f29b8 · 55f29b8
1 parent bd1fba3
commit 55f29b8
Show file tree

Hide file tree

Showing 2 changed files with 19 additions and 0 deletions.
diff --git a/packages/transducers/src/index.ts b/packages/transducers/src/index.ts
@@ -111,6 +111,7 @@ export * from "./iter/concat";
 export * from "./iter/cycle";
 export * from "./iter/iterate";
 export * from "./iter/keys";
+export * from "./iter/norm-range";
 export * from "./iter/pairs";
 export * from "./iter/permutations";
 export * from "./iter/range";

diff --git a/packages/transducers/src/iter/norm-range.ts b/packages/transducers/src/iter/norm-range.ts
@@ -0,0 +1,18 @@
+/**
+ * Yields sequence of `n+1` monotonically increasing numbers in the
+ * closed interval (0.0 .. 1.0). If `n <= 0`, yields nothing.
+ *
+ * ```
+ * [...normRange(4)]
+ * // [0, 0.25, 0.5, 0.75, 1.0]
+ * ```
+ *
+ * @param n number of steps
+ */
+export function* normRange(n: number) {
+    if (n > 0) {
+        for (let i = 0; i <= n; i++) {
+            yield i / n;
+        }
+    }
+}