JSPM

extra-iterable

2.4.37
  • ESM via JSPM
  • ES Module Entrypoint
  • Export Map
  • Keywords
  • License
  • Repository URL
  • TypeScript Types
  • README
  • Created
  • Published
  • Downloads 1092
  • Score
    100M100P100Q111431F
  • License MIT

An iterable is a sequence of values.

Package Exports

  • extra-iterable

Readme

An iterable is a sequence of values. 🏃 📼 📦 🌔 📒

Methods as separate packages:

  • @extra-iterable/swap: use rollup to bundle this es module.
  • @extra-iterable/swap.min: use in browser (browserify, uglify-js).

Some methods accept a map function for faster comparision (like unique). I find this map-approach beautiful, which i learned from Haskell's sortOn(). You can notice that i have followed Javascript naming scheme as far as possible. Some names are borrowed from Haskell, Python, Java, Processing.

Stability: Experimental.

const iterable = require('extra-iterable');
// import * as iterable from 'extra-iterable';
// import * as iterable from 'https://unpkg.com/extra-iterable@2.4.25/index.mjs'; (deno)

var x = [2, 4, 6, 8];
iterable.get(x, 1);
// 4

var x = [1, 2, 3, 4];
[...iterable.swap(x, 0, 1)];
// [ 2, 1, 3, 4 ]

var x = [1, 2, 3];
[...iterable.cycle(x, 0, 4)];
// [1, 2, 3, 1]

var x = [1, 2, 3, 4];
iterable.reduce(x, (acc, v) => acc+v);
// 10

reference

Method Action
is Checks if value is iterable.
get Gets value at index.
set Sets value at index.
swap Exchanges two values.
index Gets zero-based index.
indexRange Gets index range of part of iterable.
isEmpty Checks is iterable is empty.
size Counts the number of values.
entries Lists all index-value pairs.
iterator Gives iterator for iterable.
many Converts a once iterable to many.
from Converts iterator to iterable.
take Extracts values from left.
drop Drops values from iterable.
head Gets first value.
left Gets values from the left.
concat Appends iterables together.
push Adds values to the end.
copy Copies part of iterable to another.
fill Fills with given value.
slice Gets part of an iterable.
splice Removes or replaces existing values.
chunk Breaks iterable into chunks of given size.
cycle Gives values that cycle through an iterable.
repeat Repeats an iterable given times.
reverse Reverses the values.
rotate Rotates values in iterable.
interleave Merges values from iterables.
merge Merges values from sorted iterables.
flat Flattens nested iterable to given depth.
min Finds smallest entry.
max Finds largest entry.
range Finds smallest and largest entries.
count Counts values which satisfy a test.
partition Segregates values by test result.
cut Breaks iterable when test passes.
split Breaks iterable considering test as separator.
group Keeps similar values together and in order.
join Joins values together.
map Updates values based on map function.
filter Keeps the values which pass a test.
reduce Reduces values to a single value.
accumulate Produces accumulating values.
cartesianProduct Lists cartesian product of iterables.
zip Combines values from iterables.
unique Removes duplicate values.
union Gives values present in any iterable.
intersection Gives values present in both iterables.
difference Gives values not present in another iterable.
symmetricDifference Gives values not present in both iterables.
isUnique Checks if there are no duplicate values.
isDisjoint Checks if iterables have no value in common.
isValue Checks if iterable has a value.
isPrefix Searches a prefix.
isSuffix Checks if iterable ends with a suffix.
isInfix Checks if iterable contains an infix.
isSubsequence Checks if iterable has a subsequence.
isEqual Checks if two iterables are equal.
compare Compares two iterables.
search Searches from left, for a value passing a test.
scanWhile Scans from left, while a test passes.
find Finds first value passing a test.
forEach Calls a function for each value.
some Checks if any value satisfies a test.
every Checks if all values satisfy a test.

nodef