summaryrefslogtreecommitdiff
path: root/deps/node/deps/npm/node_modules/stream-iterate/README.md
blob: 001112045b517a61f26fddce7602221d95657f76 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
# stream-iterate

Iterate through the values in a stream.

```
npm install stream-iterate
```

[![build status](http://img.shields.io/travis/mafintosh/stream-iterate.svg?style=flat)](http://travis-ci.org/mafintosh/stream-iterate)

## Usage

``` js
var iterate = require('stream-iterate')
var from = require('from2')

var stream = from.obj(['a', 'b', 'c'])

var read = iterate(stream)

loop()

// recursively iterates through each item in the stream
function loop () {
  read(function (err, data, next) {
    console.log(err, data)
    next()
    loop()
  })
}
```

If you don't call `next` and call `read` again the same `(err, value)` pair will be returned.

You can use this module to implement stuff like [a streaming merge sort](https://github.com/mafintosh/stream-iterate/blob/master/test.js#L5-L47).

## License

[MIT](LICENSE)