= enumerabler

* http://github.com/mame/enumerabler/tree/master

== DESCRIPTION:

enumerabler enhances Enumerable with methods returning enumerator.

== FEATURES/PROBLEMS:

- Enumerable#grepper
- Enumerable#finder_all (alias: all_finder, selector)
- Enumerable#rejecter
- Enumerable#collector (alias: mapper)
- Enumerable#flat_mapper (alias: concat_collector)
- Enumerable#zipper
- Enumerable#taker
- Enumerable#taker_while
- Enumerable#dropper
- Enumerable#dropper_while

== SYNOPSIS:

require "enumerabler"

# `select' and `selector' have the almost same behavior.
ary.select {|x| x.even? }.take(10)
ary.selector {|x| x.even? }.take(10)
# While `select' returns an array, `selector' returns an Enumerator
# corresponding the array. So, the latter requires no intermediate
# array, which makes the latter more effective than the former.


# Sieve of Eratosthenes
def sieve(e, &blk)
yield n = e.first
sieve(e.rejecter {|x| x % n == 0 }, &blk)
end

sieve(2..(1.0/0.0)) {|x| p x } #=> 2, 3, 5, 7, 11, 13, 17, 19, 23, ...


# Fibonacci numbers
def fibonacci
Enumerator.new do |e|
e << 1
e << 1
fibonacci.zip(fibonacci.dropper(1)) {|x, y| e << x + y }
end
end

fibonacci.each {|x| p x } #=> 1, 1, 2, 3, 5, 8, 13, 21, 34, 55, 89, ...

== REQUIREMENTS:

None

== INSTALL:

* gem install enumerabler

== LICENSE:

Copyright:: Yusuke Endoh <mame@tsg.ne.jp>
License:: Ruby's