文件列表:

.editorconfig (20, 2022-01-24)
.npmignore (58, 2022-01-24)
.prettierrc (187, 2022-01-24)
Iterable.js (1917, 2022-01-24)
__tests__ (0, 2022-01-24)
__tests__\Iterable.js (5389, 2022-01-24)
__tests__\drop.js (1665, 2022-01-24)
__tests__\every.js (3226, 2022-01-24)
__tests__\filter.js (4130, 2022-01-24)
__tests__\find.js (3276, 2022-01-24)
__tests__\forEach.js (3654, 2022-01-24)
__tests__\index.js (847, 2022-01-24)
__tests__\len.js (1002, 2022-01-24)
__tests__\map.js (4283, 2022-01-24)
__tests__\range.js (767, 2022-01-24)
__tests__\reduce.js (4241, 2022-01-24)
__tests__\some.js (3212, 2022-01-24)
__tests__\take.js (1670, 2022-01-24)
__tests__\zip.js (2465, 2022-01-24)
apply (0, 2022-01-24)
apply\drop.js (167, 2022-01-24)
apply\every.js (195, 2022-01-24)
apply\filter.js (243, 2022-01-24)
apply\find.js (278, 2022-01-24)
apply\forEach.js (155, 2022-01-24)
apply\map.js (161, 2022-01-24)
apply\reduce.js (224, 2022-01-24)
apply\some.js (192, 2022-01-24)
apply\take.js (216, 2022-01-24)
drop.js (364, 2022-01-24)
every.js (214, 2022-01-24)
filter.js (396, 2022-01-24)
find.js (211, 2022-01-24)
forEach.js (217, 2022-01-24)
... ...

# Standard ## Import To install, run either `npm install --save @ayc0/std` or `yarn add @ayc0/std`, and then: ```js const std = require('@ayc0/std'); const multiplyBy2 = std.map(x => x * 2); // OR const map = require('@ayc0/std/map'); const multiplyBy2 = map(x => x * 2); // And then you can use it: const input = [1, 2]; const output = multiplyBy2(input); ``` ## Supported functions For all of the functions listed below, you can either do `std.` or import them from `@ayc0/std/`: - [range](https://github.com/Ayc0/std/blob/master/#range) - [zip](https://github.com/Ayc0/std/blob/master/#zip) - [len](https://github.com/Ayc0/std/blob/master/#len) - [map](https://github.com/Ayc0/std/blob/master/#map) - [forEach](https://github.com/Ayc0/std/blob/master/#foreach) - [filter](https://github.com/Ayc0/std/blob/master/#filter) - [reduce](https://github.com/Ayc0/std/blob/master/#reduce) - [take](https://github.com/Ayc0/std/blob/master/#take) - [drop](https://github.com/Ayc0/std/blob/master/#drop) - [find](https://github.com/Ayc0/std/blob/master/#find) - [every](https://github.com/Ayc0/std/blob/master/#every) - [some](https://github.com/Ayc0/std/blob/master/#some) - [Iterable](https://github.com/Ayc0/std/blob/master/#iterable) ### Range ```js function* range([from,] to[, step]) { // yield every steps } ``` ### Zip ```js function* zip(iterables) { // yield [currentValues, indexes, iterables] } ``` #### Supported iterables - array - string - Map - Set - Object - iterators #### Examples ```js for (const [currentValues, indexes, iterables] of zip([ '123', [1, 2, 3], { a: 1, b: 2, c: 3 }, ])) { console.log(currentValues); // [ '1', 1, 1 ] // [ '2', 2, 2 ] // [ '3', 3, 3 ] console.log(indexes); // [ 0, 0, 'a' ] // [ 1, 1, 'b' ] // [ 2, 2, 'c' ] } ``` ### Len ```js function len(iterable) { // return length of iterable } ``` #### Supported iterables - array - string - Map - Set - Object - iterators ### Map ```js function map(callback[, thisArg]) { return function (iterable) { // return new iterable of the input iterable type } } function callback(currentValue[, index[, iterable]]) { // return new element of iterable } ``` #### Supported iterables - array - string - Map - Set - Object - iterators #### Examples ```js map(x => x * 2)({ a: 1, b: 2 }); // { a: 2, b: 4 } map(x => x * 2)([1, 2]); // [ 2, 4 ] map(x => x * 2)(new Set([1, 2])); // Set(2) {2, 4} map(x => x * 2)( new Map([ ['a', 1], ['b', 2], ]), ); // Map(2) {"a" => 2, "b" => 4} map(x => x.repeat(2))('ab'); // 'aabb' ``` ### ForEach ```js function forEach(callback[, thisArg]) { return function (iterable) { } } function callback(currentValue[, index[, iterable]]) { } ``` #### Supported iterables - array - string - Map - Set - Object - iterators #### Examples ```js forEach(x => console.log(x * 2))({ a: 1, b: 2 }); // 2 // 4 forEach(x => console.log(x * 2))([1, 2]); // 2 // 4 forEach(x => console.log(x * 2))(new Set([1, 2])); // 2 // 4 forEach(x => console.log(x * 2))( new Map([ ['a', 1], ['b', 2], ]), ); // 2 // 4 forEach(x => console.log(x.repeat(2)))('ab'); // aa // bb ``` ### Filter ```js function filter(callback[, thisArg]) { return function (iterable) { // return new iterable of the input iterable type } } function callback(currentValue[, index[, iterable]]) { // return if you should keep this element of not } ``` #### Supported iterables - array - string - Map - Set - Object - iterators #### Examples ```js filter(x => x % 2)({ a: 1, b: 2 }); // { a: 1 } filter(x => x % 2)([1, 2]); // [ 1 ] filter(x => x % 2)(new Set([1, 2])); // Set(1) {1} filter(x => x % 2)( new Map([ ['a', 1], ['b', 2], ]), ); // Map(1) {"a" => 1} filter(x => x % 2)('12'); // '1' ``` ### Reduce ```js function reduce(callback, initialValue, thisArg) { return function (iterable) { // return reduced value }; } function callback(accumulator, currentValue[, index[, iterable]]) { // returns the value that results from the reduction } ``` #### Supported iterables - array - string - Map - Set - Object - iterators #### Examples ```js reduce((acc, x) => acc + x, 0)({ a: 1, b: 2 }); // { a: 1 } reduce((acc, x) => acc + x, 0)([1, 2]); // [ 1 ] reduce((acc, x) => acc + x, 0)(new Set([1, 2])); // Set(1) {1} reduce( (acc, x) => acc + x, 0, )( new Map([ ['a', 1], ['b', 2], ]), ); // Map(1) {"a" => 1} reduce((acc, x) => acc + Number(x), 0)('12'); // '1' ``` ### Take ```js function take(limit) { return function (iterable) { // return new iterable with only the first items }; } ``` #### Supported iterables - array - string - Map - Set - Object - iterators #### Examples ```js take(1)({ a: 1, b: 2 }); // { a: 1 } take(1)([1, 2]); // [ 1 ] take(1)(new Set([1, 2])); // Set(1) {1} take(1)( new Map([ ['a', 1], ['b', 2], ]), ); // Map(1) {"a" => 1} take(1)('ab'); // 'a' ``` ### Drop ```js function drop(limit) { return function (iterable) { // return new iterable with first item trimmed }; } ``` #### Supported iterables - array - string - Map - Set - Object - iterators #### Examples ```js drop(1)({ a: 1, b: 2 }); // { b: 2 } drop(1)([1, 2]); // [ 2 ] drop(1)(new Set([1, 2])); // Set(1) {2} drop(1)( new Map([ ['a', 1], ['b', 2], ]), ); // Map(1) {"b" => 2} drop(1)('ab'); // 'b' ``` ### Find ```js function find(callback[, thisArg]) { return function (iterable) { // return the element and its key or undefined } } function callback(currentValue[, index[, iterable]]) { // return if you it matches your element or not } ``` #### Supported iterables - array - string - Map - Set - Object - iterators #### Examples ```js find(x => x % 2)({ a: 1, b: 2 }); // [ 1, 'a' ] find(x => x % 2)([1, 2]); // [ 1, 0 ] find(x => x % 2)(new Set([1, 2])); // [ 1, 0 ] find(x => x % 2)( new Map([ ['a', 1], ['b', 2], ]), ); // [ 1, 'a' ] find(x => x % 2)('12'); // [ '1', 0 ] ``` ### Every ```js function every(callback[, thisArg]) { return function (iterable) { // return true if all elements match the callback } } function callback(currentValue[, index[, iterable]]) { // return if you it matches your element or not } ``` #### Supported iterables - array - string - Map - Set - Object - iterators #### Examples ```js every(x => x <= 2)({ a: 1, b: 2 }); // true every(x => x <= 2)([1, 2]); // true every(x => x <= 2)(new Set([1, 2])); // true every(x => x <= 2)( new Map([ ['a', 1], ['b', 2], ]), ); // true every(x => x === '1')('12'); // false ``` ### Some ```js function some(callback[, thisArg]) { return function (iterable) { // return true if at least 1 element matches the callback } } function callback(currentValue[, index[, iterable]]) { // return if you it matches your element or not } ``` #### Supported iterables - array - string - Map - Set - Object - iterators #### Examples ```js some(x => x <= 2)({ a: 1, b: 2 }); // true some(x => x <= 2)([1, 2]); // true some(x => x <= 2)(new Set([1, 2])); // true some(x => x <= 2)( new Map([ ['a', 1], ['b', 2], ]), ); // true some(x => x === '1')('12'); // true ``` ### Iterator `Iterator` allows you to chain operations more easily. It supports all these methods: - `drop` - `take` - `map` - `filter` - `every` - `some` - `reduce` - `find` - `len` - `forEach` You can also use the method `build()` to reconstruct an iterable (either from the same type as the input, or you can transform it). #### Supported iterables - array - string - Map - Set - Object - iterators #### Examples ```js const iterable = Iterable.from([1, 2, 3, 4, 5, 6, 7, 8, 9, 10]); iterable .drop(1) .filter(x => x % 2 === 0) .map(x => x * 3) .take(2) .build(); // [6, 12] ``` `build()` accepts an optional parameter `type`: ```js const iterable = Iterable.from([1, 2, 3]); iterable.build(type.Set); // Set([1, 2, 3]) ```

近期下载者：

相关文件：

评论：[我要评论] [举报此文件]

收藏者：