facets 2.4.5 → 2.5.0

data/doc/rdoc/more/classes/Enumerable.html

@@ -59,6 +59,7 @@
         <td>
 <a href="../files/lib/more/facets/thread_rb.html">lib/more/facets/thread.rb</a>
 <a href="../files/lib/more/facets/elementwise_rb.html">lib/more/facets/elementwise.rb</a>
+<a href="../files/lib/more/facets/filter_rb.html">lib/more/facets/filter.rb</a>
 <a href="../files/lib/more/facets/elementor_rb.html">lib/more/facets/elementor.rb</a>
         </td>
       </tr>
@@ -75,21 +76,23 @@
 
 
   <div class="sectiontitle">Methods</div>
-  <span style="padding-right: 5px;"><a href="#M000947">elements</a></span>
-  <span style="padding-right: 5px;"><a href="#M000948">elements!</a></span>
-  <span style="padding-right: 5px;"><a href="#M000941">elementwise</a></span>
-  <span style="padding-right: 5px;"><a href="#M000945">every</a></span>
-  <span style="padding-right: 5px;"><a href="#M000946">every!</a></span>
-  <span style="padding-right: 5px;"><a href="#M000942">ewise</a></span>
-  <span style="padding-right: 5px;"><a href="#M000944">per</a></span>
-  <span style="padding-right: 5px;"><a href="#M000939">threaded_map</a></span>
-  <span style="padding-right: 5px;"><a href="#M000940">threaded_map_send</a></span>
-  <span style="padding-right: 5px;"><a href="#M000943">to_elem</a></span>
+  <span style="padding-right: 5px;"><a href="#M000981">elements</a></span>
+  <span style="padding-right: 5px;"><a href="#M000982">elements!</a></span>
+  <span style="padding-right: 5px;"><a href="#M000974">elementwise</a></span>
+  <span style="padding-right: 5px;"><a href="#M000979">every</a></span>
+  <span style="padding-right: 5px;"><a href="#M000980">every!</a></span>
+  <span style="padding-right: 5px;"><a href="#M000975">ewise</a></span>
+  <span style="padding-right: 5px;"><a href="#M000976">filter</a></span>
+  <span style="padding-right: 5px;"><a href="#M000978">per</a></span>
+  <span style="padding-right: 5px;"><a href="#M000972">threaded_map</a></span>
+  <span style="padding-right: 5px;"><a href="#M000973">threaded_map_send</a></span>
+  <span style="padding-right: 5px;"><a href="#M000977">to_elem</a></span>
 
 
 
   <div class="sectiontitle">Classes and Modules</div>
-  Class <a href="Enumerable/Elementor.html" class="link">Enumerable::Elementor</a><br />
+  Module <a href="Enumerable/Filterable.html" class="link">Enumerable::Filterable</a><br />
+Class <a href="Enumerable/Elementor.html" class="link">Enumerable::Elementor</a><br />
 Class <a href="Enumerable/Enumerator.html" class="link">Enumerable::Enumerator</a><br />
 
 
@@ -98,32 +101,32 @@ Class <a href="Enumerable/Enumerator.html" class="link">Enumerable::Enumerator</
 <div class="sectiontitle">Public Instance methods</div>
 <div class="method">
   <div class="title">
-    <a name="M000947"></a><b>elements</b>()
+    <a name="M000981"></a><b>elements</b>()
   </div>
   <div class="description">
   <p>
-Alias for <a href="Enumerable.html#M000945">every</a>
+Alias for <a href="Enumerable.html#M000979">every</a>
 </p>
   </div>
 </div>
 <div class="method">
   <div class="title">
-    <a name="M000948"></a><b>elements!</b>()
+    <a name="M000982"></a><b>elements!</b>()
   </div>
   <div class="description">
   <p>
-Alias for <a href="Enumerable.html#M000945">every</a>!
+Alias for <a href="Enumerable.html#M000979">every</a>!
 </p>
   </div>
 </div>
 <div class="method">
   <div class="title">
-    <a name="M000941"></a><b>elementwise</b>(count=1)
+    <a name="M000974"></a><b>elementwise</b>(count=1)
   </div>
   <div class="description">
   <p>
-Returns an <a href="Enumerable.html#M000941">elementwise</a> Functor
-designed to make R-like <a href="Enumerable.html#M000941">elementwise</a>
+Returns an <a href="Enumerable.html#M000974">elementwise</a> Functor
+designed to make R-like <a href="Enumerable.html#M000974">elementwise</a>
 operations possible.
 </p>
 <pre>
@@ -134,11 +137,11 @@ operations possible.
   </div>
 <div class="aka">
   This method is also aliased as
-  <a href="Enumerable.html#M000942">ewise</a>
+  <a href="Enumerable.html#M000975">ewise</a>
 </div>
 <div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000941_source')" id="l_M000941_source">+</a> ]</p>
-  <div id="M000941_source" class="dyn-source">
+  <p class="source-link">[ <a href="javascript:toggleSource('M000974_source')" id="l_M000974_source">+</a> ]</p>
+  <div id="M000974_source" class="dyn-source">
 <pre>
 <span class="ruby-comment cmt"># File lib/more/facets/elementwise.rb, line 16</span>
   <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">elementwise</span>(<span class="ruby-identifier">count</span>=<span class="ruby-value">1</span>)
@@ -179,12 +182,12 @@ operations possible.
 </div>
 <div class="method">
   <div class="title">
-    <a name="M000945"></a><b>every</b>()
+    <a name="M000979"></a><b>every</b>()
   </div>
   <div class="description">
   <p>
 Returns an elemental object. This allows you to map a method on to <a
-href="Enumerable.html#M000945">every</a> element.
+href="Enumerable.html#M000979">every</a> element.
 </p>
 <pre>
   r = [1,2,3].every + 3  #=&gt; [4,5,6]
@@ -192,11 +195,11 @@ href="Enumerable.html#M000945">every</a> element.
   </div>
 <div class="aka">
   This method is also aliased as
-  <a href="Enumerable.html#M000947">elements</a>
+  <a href="Enumerable.html#M000981">elements</a>
 </div>
 <div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000945_source')" id="l_M000945_source">+</a> ]</p>
-  <div id="M000945_source" class="dyn-source">
+  <p class="source-link">[ <a href="javascript:toggleSource('M000979_source')" id="l_M000979_source">+</a> ]</p>
+  <div id="M000979_source" class="dyn-source">
 <pre>
 <span class="ruby-comment cmt"># File lib/more/facets/elementor.rb, line 57</span>
   <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">every</span>
@@ -208,20 +211,20 @@ href="Enumerable.html#M000945">every</a> element.
 </div>
 <div class="method">
   <div class="title">
-    <a name="M000946"></a><b>every!</b>()
+    <a name="M000980"></a><b>every!</b>()
   </div>
   <div class="description">
   <p>
-In place version of <a href="Enumerable.html#M000945">every</a>.
+In place version of <a href="Enumerable.html#M000979">every</a>.
 </p>
   </div>
 <div class="aka">
   This method is also aliased as
-  <a href="Enumerable.html#M000948">elements!</a>
+  <a href="Enumerable.html#M000982">elements!</a>
 </div>
 <div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000946_source')" id="l_M000946_source">+</a> ]</p>
-  <div id="M000946_source" class="dyn-source">
+  <p class="source-link">[ <a href="javascript:toggleSource('M000980_source')" id="l_M000980_source">+</a> ]</p>
+  <div id="M000980_source" class="dyn-source">
 <pre>
 <span class="ruby-comment cmt"># File lib/more/facets/elementor.rb, line 63</span>
   <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">every!</span>
@@ -234,21 +237,81 @@ In place version of <a href="Enumerable.html#M000945">every</a>.
 </div>
 <div class="method">
   <div class="title">
-    <a name="M000942"></a><b>ewise</b>(count=1)
+    <a name="M000975"></a><b>ewise</b>(count=1)
   </div>
   <div class="description">
   <p>
-Alias for <a href="Enumerable.html#M000941">elementwise</a>
+Alias for <a href="Enumerable.html#M000974">elementwise</a>
 </p>
   </div>
 </div>
 <div class="method">
   <div class="title">
-    <a name="M000944"></a><b>per</b>()
+    <a name="M000976"></a><b>filter</b>() {|output, *input| ...}
+  </div>
+  <div class="description">
+  <p>
+Without a block: wrap the <a href="Enumerable.html">Enumerable</a> object
+in such a way that map, select and similar operations are performed
+&quot;horizontally&quot; across a series of blocks, instead of building an
+array of results at each step. This reduces memory usage, allows partial
+results to be provided early, and permits working with infinite series.
+</p>
+<pre>
+  (1..1_000_000_000).filter.select{ |i| i % 2 == 0 }.
+                            map{ |i| i + 100 }.
+                            take(10).to_a
+</pre>
+<p>
+With a block: the block acts as an arbitrary <a
+href="Enumerable.html#M000976">filter</a> on the data. Unlike map, it can
+choose to drop <a href="Enumerable.html#M000981">elements</a> from the
+result, and/or add additional ones. The first object passed to the block is
+the receiver of the output.
+</p>
+<pre>
+  (1..1_000_000_000).
+    filter { |out,i| out &lt;&lt; i if i % 2 == 0 }.  # like select
+    filter { |out,i| out &lt;&lt; i + 100 }.          # like map
+    take(10).each { |i| puts i }
+</pre>
+<p>
+Use a method like to_a or to_h at the end of the chain if you want an Array
+or <a href="Hash.html">Hash</a> built with the results, or each { &#8230; }
+if you just want to output each result and discard it.
+</p>
   </div>
 <div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000944_source')" id="l_M000944_source">+</a> ]</p>
-  <div id="M000944_source" class="dyn-source">
+  <p class="source-link">[ <a href="javascript:toggleSource('M000976_source')" id="l_M000976_source">+</a> ]</p>
+  <div id="M000976_source" class="dyn-source">
+<pre>
+<span class="ruby-comment cmt"># File lib/more/facets/filter.rb, line 30</span>
+  <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">filter</span>(<span class="ruby-operator">&amp;</span><span class="ruby-identifier">blk</span>)
+    <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">block_given?</span>
+      <span class="ruby-constant">Enumerator</span><span class="ruby-operator">::</span><span class="ruby-constant">Filter</span>.<span class="ruby-identifier">new</span> <span class="ruby-keyword kw">do</span> <span class="ruby-operator">|</span><span class="ruby-identifier">output</span><span class="ruby-operator">|</span>
+        <span class="ruby-identifier">each</span> <span class="ruby-keyword kw">do</span> <span class="ruby-operator">|</span><span class="ruby-operator">*</span><span class="ruby-identifier">input</span><span class="ruby-operator">|</span>
+          <span class="ruby-keyword kw">yield</span> <span class="ruby-identifier">output</span>, <span class="ruby-operator">*</span><span class="ruby-identifier">input</span>
+        <span class="ruby-keyword kw">end</span>
+      <span class="ruby-keyword kw">end</span>
+    <span class="ruby-keyword kw">else</span>
+      <span class="ruby-constant">Enumerator</span><span class="ruby-operator">::</span><span class="ruby-constant">Filter</span>.<span class="ruby-identifier">new</span> <span class="ruby-keyword kw">do</span> <span class="ruby-operator">|</span><span class="ruby-identifier">output</span><span class="ruby-operator">|</span>
+        <span class="ruby-identifier">each</span> <span class="ruby-keyword kw">do</span> <span class="ruby-operator">|</span><span class="ruby-operator">*</span><span class="ruby-identifier">input</span><span class="ruby-operator">|</span>
+          <span class="ruby-identifier">output</span>.<span class="ruby-identifier">yield</span> <span class="ruby-operator">*</span><span class="ruby-identifier">input</span>
+        <span class="ruby-keyword kw">end</span>
+      <span class="ruby-keyword kw">end</span>
+    <span class="ruby-keyword kw">end</span>
+  <span class="ruby-keyword kw">end</span>
+</pre>
+  </div>
+</div>
+</div>
+<div class="method">
+  <div class="title">
+    <a name="M000978"></a><b>per</b>()
+  </div>
+<div class="sourcecode">
+  <p class="source-link">[ <a href="javascript:toggleSource('M000978_source')" id="l_M000978_source">+</a> ]</p>
+  <div id="M000978_source" class="dyn-source">
 <pre>
 <span class="ruby-comment cmt"># File lib/more/facets/elementor.rb, line 46</span>
   <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">per</span>
@@ -262,19 +325,19 @@ Alias for <a href="Enumerable.html#M000941">elementwise</a>
 </div>
 <div class="method">
   <div class="title">
-    <a name="M000939"></a><b>threaded_map</b>( {|| ...}
+    <a name="M000972"></a><b>threaded_map</b>( {|| ...}
   </div>
   <div class="description">
   <p>
 Like Enumerable#map but each iteration is processed via a separate thread.
 </p>
-<pre>
- CREDIT Sean O'Halpin
-</pre>
+<p>
+CREDIT Sean O&#8216;Halpin
+</p>
   </div>
 <div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000939_source')" id="l_M000939_source">+</a> ]</p>
-  <div id="M000939_source" class="dyn-source">
+  <p class="source-link">[ <a href="javascript:toggleSource('M000972_source')" id="l_M000972_source">+</a> ]</p>
+  <div id="M000972_source" class="dyn-source">
 <pre>
 <span class="ruby-comment cmt"># File lib/more/facets/thread.rb, line 37</span>
   <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">threaded_map</span> <span class="ruby-comment cmt">#:yield:</span>
@@ -286,20 +349,20 @@ Like Enumerable#map but each iteration is processed via a separate thread.
 </div>
 <div class="method">
   <div class="title">
-    <a name="M000940"></a><b>threaded_map_send</b>(meth, *args, &amp;block)
+    <a name="M000973"></a><b>threaded_map_send</b>(meth, *args, &amp;block)
   </div>
   <div class="description">
   <p>
 Like Enumerable#map_send but each iteration is processed via a separate
 thread.
 </p>
-<pre>
- CREDIT Sean O'Halpin
-</pre>
+<p>
+CREDIT Sean O&#8216;Halpin
+</p>
   </div>
 <div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000940_source')" id="l_M000940_source">+</a> ]</p>
-  <div id="M000940_source" class="dyn-source">
+  <p class="source-link">[ <a href="javascript:toggleSource('M000973_source')" id="l_M000973_source">+</a> ]</p>
+  <div id="M000973_source" class="dyn-source">
 <pre>
 <span class="ruby-comment cmt"># File lib/more/facets/thread.rb, line 46</span>
   <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">threaded_map_send</span>(<span class="ruby-identifier">meth</span>, <span class="ruby-operator">*</span><span class="ruby-identifier">args</span>, <span class="ruby-operator">&amp;</span><span class="ruby-identifier">block</span>)
@@ -311,7 +374,7 @@ thread.
 </div>
 <div class="method">
   <div class="title">
-    <a name="M000943"></a><b>to_elem</b>(meth=nil)
+    <a name="M000977"></a><b>to_elem</b>(meth=nil)
   </div>
   <div class="description">
   <p>
@@ -319,8 +382,8 @@ Create <a href="Enumerable/Elementor.html">Elementor</a>.
 </p>
   </div>
 <div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000943_source')" id="l_M000943_source">+</a> ]</p>
-  <div id="M000943_source" class="dyn-source">
+  <p class="source-link">[ <a href="javascript:toggleSource('M000977_source')" id="l_M000977_source">+</a> ]</p>
+  <div id="M000977_source" class="dyn-source">
 <pre>
 <span class="ruby-comment cmt"># File lib/more/facets/elementor.rb, line 42</span>
   <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">to_elem</span>(<span class="ruby-identifier">meth</span>=<span class="ruby-keyword kw">nil</span>)

data/doc/rdoc/more/classes/Enumerable/Elementor.html

@@ -85,10 +85,10 @@ applied to it are routed to each element.
 
 
   <div class="sectiontitle">Methods</div>
-  <span style="padding-right: 5px;"><a href="#M000950">instance_delegate</a></span>
-  <span style="padding-right: 5px;"><a href="#M000951">instance_operator</a></span>
-  <span style="padding-right: 5px;"><a href="#M000952">method_missing</a></span>
-  <span style="padding-right: 5px;"><a href="#M000949">new</a></span>
+  <span style="padding-right: 5px;"><a href="#M000991">instance_delegate</a></span>
+  <span style="padding-right: 5px;"><a href="#M000992">instance_operator</a></span>
+  <span style="padding-right: 5px;"><a href="#M000993">method_missing</a></span>
+  <span style="padding-right: 5px;"><a href="#M000990">new</a></span>
 
 
 
@@ -98,11 +98,11 @@ applied to it are routed to each element.
 <div class="sectiontitle">Public Class methods</div>
 <div class="method">
   <div class="title">
-    <a name="M000949"></a><b>new</b>(elem_object, elem_method=nil)
+    <a name="M000990"></a><b>new</b>(elem_object, elem_method=nil)
   </div>
 <div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000949_source')" id="l_M000949_source">+</a> ]</p>
-  <div id="M000949_source" class="dyn-source">
+  <p class="source-link">[ <a href="javascript:toggleSource('M000990_source')" id="l_M000990_source">+</a> ]</p>
+  <div id="M000990_source" class="dyn-source">
 <pre>
 <span class="ruby-comment cmt"># File lib/more/facets/elementor.rb, line 101</span>
   <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">initialize</span>(<span class="ruby-identifier">elem_object</span>, <span class="ruby-identifier">elem_method</span>=<span class="ruby-keyword kw">nil</span>)
@@ -116,11 +116,11 @@ applied to it are routed to each element.
 <div class="sectiontitle">Public Instance methods</div>
 <div class="method">
   <div class="title">
-    <a name="M000950"></a><b>instance_delegate</b>()
+    <a name="M000991"></a><b>instance_delegate</b>()
   </div>
 <div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000950_source')" id="l_M000950_source">+</a> ]</p>
-  <div id="M000950_source" class="dyn-source">
+  <p class="source-link">[ <a href="javascript:toggleSource('M000991_source')" id="l_M000991_source">+</a> ]</p>
+  <div id="M000991_source" class="dyn-source">
 <pre>
 <span class="ruby-comment cmt"># File lib/more/facets/elementor.rb, line 106</span>
   <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">instance_delegate</span>
@@ -132,11 +132,11 @@ applied to it are routed to each element.
 </div>
 <div class="method">
   <div class="title">
-    <a name="M000951"></a><b>instance_operator</b>()
+    <a name="M000992"></a><b>instance_operator</b>()
   </div>
 <div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000951_source')" id="l_M000951_source">+</a> ]</p>
-  <div id="M000951_source" class="dyn-source">
+  <p class="source-link">[ <a href="javascript:toggleSource('M000992_source')" id="l_M000992_source">+</a> ]</p>
+  <div id="M000992_source" class="dyn-source">
 <pre>
 <span class="ruby-comment cmt"># File lib/more/facets/elementor.rb, line 110</span>
   <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">instance_operator</span>
@@ -148,11 +148,11 @@ applied to it are routed to each element.
 </div>
 <div class="method">
   <div class="title">
-    <a name="M000952"></a><b>method_missing</b>(sym,*args,&amp;blk)
+    <a name="M000993"></a><b>method_missing</b>(sym,*args,&amp;blk)
   </div>
 <div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000952_source')" id="l_M000952_source">+</a> ]</p>
-  <div id="M000952_source" class="dyn-source">
+  <p class="source-link">[ <a href="javascript:toggleSource('M000993_source')" id="l_M000993_source">+</a> ]</p>
+  <div id="M000993_source" class="dyn-source">
 <pre>
 <span class="ruby-comment cmt"># File lib/more/facets/elementor.rb, line 114</span>
   <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">method_missing</span>(<span class="ruby-identifier">sym</span>,<span class="ruby-operator">*</span><span class="ruby-identifier">args</span>,<span class="ruby-operator">&amp;</span><span class="ruby-identifier">blk</span>)

data/doc/rdoc/more/classes/Enumerable/Enumerator.html

@@ -79,7 +79,7 @@ Object
 
 
   <div class="sectiontitle">Methods</div>
-  <span style="padding-right: 5px;"><a href="#M000953">to_elem</a></span>
+  <span style="padding-right: 5px;"><a href="#M000994">to_elem</a></span>
 
 
 
@@ -89,7 +89,7 @@ Object
 <div class="sectiontitle">Public Instance methods</div>
 <div class="method">
   <div class="title">
-    <a name="M000953"></a><b>to_elem</b>(meth=nil)
+    <a name="M000994"></a><b>to_elem</b>(meth=nil)
   </div>
   <div class="description">
   <p>
@@ -97,8 +97,8 @@ Create <a href="Elementor.html">Elementor</a>.
 </p>
   </div>
 <div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000953_source')" id="l_M000953_source">+</a> ]</p>
-  <div id="M000953_source" class="dyn-source">
+  <p class="source-link">[ <a href="javascript:toggleSource('M000994_source')" id="l_M000994_source">+</a> ]</p>
+  <div id="M000994_source" class="dyn-source">
 <pre>
 <span class="ruby-comment cmt"># File lib/more/facets/elementor.rb, line 124</span>
   <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">to_elem</span>(<span class="ruby-identifier">meth</span>=<span class="ruby-keyword kw">nil</span>)

data/doc/rdoc/more/classes/Enumerable/Filterable.html

@@ -0,0 +1,246 @@
+<?xml version="1.0" encoding="iso-8859-1"?>
+<!DOCTYPE html 
+     PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
+     "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+<html>
+  <head>
+    <title>Module: Enumerable::Filterable</title>
+    <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1" />
+    <link rel="stylesheet" href="../.././rdoc-style.css" type="text/css" media="screen" />
+
+    <script language="JavaScript" type="text/javascript">
+    // <![CDATA[
+
+        function toggleSource( id )
+        {
+          var elem
+          var link
+
+          if( document.getElementById )
+          {
+            elem = document.getElementById( id )
+            link = document.getElementById( "l_" + id )
+          }
+          else if ( document.all )
+          {
+            elem = eval( "document.all." + id )
+            link = eval( "document.all.l_" + id )
+          }
+          else
+            return false;
+
+          if( elem.style.display == "block" )
+          {
+            elem.style.display = "none"
+            link.innerHTML = "+"
+          }
+          else
+          {
+            elem.style.display = "block"
+            link.innerHTML = "-"
+          }
+        }
+
+        function openCode( url )
+        {
+          window.open( url, "SOURCE_CODE", "resizable=yes,scrollbars=yes,toolbar=no,status=no,height=480,width=750" ).focus();
+        }
+      // ]]>
+    </script>
+  </head>
+
+  <body>
+  <table width="100%" border='0' cellpadding='0' cellspacing='0' class='banner'><tr>
+  <td class="file-title"><span class="file-title-prefix">Module</span><br />Enumerable::Filterable</td>
+  <td align="right">
+    <table cellspacing="0" cellpadding="2">
+      <tr valign="top">
+        <td>In:</td>
+        <td>
+<a href="../../files/lib/more/facets/filter_rb.html">lib/more/facets/filter.rb</a>
+        </td>
+      </tr>
+         </table>
+        </td>
+        </tr>
+      </table>
+ <!-- banner header -->
+
+  <div id="bodyContent">
+      <div id="content">
+
+  <div class="description"><h1><a href="Filterable.html">Filterable</a></h1>
+<p>
+Classes which include <a href="Filterable.html">Enumerable::Filterable</a>
+will get versions of <a href="Filterable.html#M000983">map</a>, <a
+href="Filterable.html#M000985">select</a> etc. which return a Filter, so
+that they work horizontally without creating intermediate arrays.
+</p>
+</div>
+
+
+
+  <div class="sectiontitle">Methods</div>
+  <span style="padding-right: 5px;"><a href="#M000984">collect</a></span>
+  <span style="padding-right: 5px;"><a href="#M000986">find_all</a></span>
+  <span style="padding-right: 5px;"><a href="#M000983">map</a></span>
+  <span style="padding-right: 5px;"><a href="#M000987">reject</a></span>
+  <span style="padding-right: 5px;"><a href="#M000985">select</a></span>
+  <span style="padding-right: 5px;"><a href="#M000989">skip</a></span>
+  <span style="padding-right: 5px;"><a href="#M000988">take</a></span>
+
+
+
+
+
+
+<div class="sectiontitle">Public Instance methods</div>
+<div class="method">
+  <div class="title">
+    <a name="M000984"></a><b>collect</b>()
+  </div>
+  <div class="description">
+  <p>
+Alias for <a href="Filterable.html#M000983">map</a>
+</p>
+  </div>
+</div>
+<div class="method">
+  <div class="title">
+    <a name="M000986"></a><b>find_all</b>()
+  </div>
+  <div class="description">
+  <p>
+Alias for <a href="Filterable.html#M000985">select</a>
+</p>
+  </div>
+</div>
+<div class="method">
+  <div class="title">
+    <a name="M000983"></a><b>map</b>() {|*input| ...}
+  </div>
+<div class="aka">
+  This method is also aliased as
+  <a href="Filterable.html#M000984">collect</a>
+</div>
+<div class="sourcecode">
+  <p class="source-link">[ <a href="javascript:toggleSource('M000983_source')" id="l_M000983_source">+</a> ]</p>
+  <div id="M000983_source" class="dyn-source">
+<pre>
+<span class="ruby-comment cmt"># File lib/more/facets/filter.rb, line 53</span>
+    <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">map</span>
+      <span class="ruby-constant">Enumerator</span><span class="ruby-operator">::</span><span class="ruby-constant">Filter</span>.<span class="ruby-identifier">new</span> <span class="ruby-keyword kw">do</span> <span class="ruby-operator">|</span><span class="ruby-identifier">output</span><span class="ruby-operator">|</span>
+        <span class="ruby-identifier">each</span> <span class="ruby-keyword kw">do</span> <span class="ruby-operator">|</span><span class="ruby-operator">*</span><span class="ruby-identifier">input</span><span class="ruby-operator">|</span>
+          <span class="ruby-identifier">output</span>.<span class="ruby-identifier">yield</span> <span class="ruby-keyword kw">yield</span>(<span class="ruby-operator">*</span><span class="ruby-identifier">input</span>)
+        <span class="ruby-keyword kw">end</span>
+      <span class="ruby-keyword kw">end</span>
+    <span class="ruby-keyword kw">end</span>
+</pre>
+  </div>
+</div>
+</div>
+<div class="method">
+  <div class="title">
+    <a name="M000987"></a><b>reject</b>() {|*input| ...}
+  </div>
+<div class="sourcecode">
+  <p class="source-link">[ <a href="javascript:toggleSource('M000987_source')" id="l_M000987_source">+</a> ]</p>
+  <div id="M000987_source" class="dyn-source">
+<pre>
+<span class="ruby-comment cmt"># File lib/more/facets/filter.rb, line 71</span>
+    <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">reject</span>
+      <span class="ruby-constant">Enumerator</span><span class="ruby-operator">::</span><span class="ruby-constant">Filter</span>.<span class="ruby-identifier">new</span> <span class="ruby-keyword kw">do</span> <span class="ruby-operator">|</span><span class="ruby-identifier">output</span><span class="ruby-operator">|</span>
+        <span class="ruby-identifier">each</span> <span class="ruby-keyword kw">do</span> <span class="ruby-operator">|</span><span class="ruby-operator">*</span><span class="ruby-identifier">input</span><span class="ruby-operator">|</span>
+          <span class="ruby-identifier">output</span>.<span class="ruby-identifier">yield</span>(<span class="ruby-operator">*</span><span class="ruby-identifier">input</span>) <span class="ruby-keyword kw">unless</span> <span class="ruby-keyword kw">yield</span>(<span class="ruby-operator">*</span><span class="ruby-identifier">input</span>)
+        <span class="ruby-keyword kw">end</span>
+      <span class="ruby-keyword kw">end</span>
+    <span class="ruby-keyword kw">end</span>
+</pre>
+  </div>
+</div>
+</div>
+<div class="method">
+  <div class="title">
+    <a name="M000985"></a><b>select</b>() {|*input| ...}
+  </div>
+<div class="aka">
+  This method is also aliased as
+  <a href="Filterable.html#M000986">find_all</a>
+</div>
+<div class="sourcecode">
+  <p class="source-link">[ <a href="javascript:toggleSource('M000985_source')" id="l_M000985_source">+</a> ]</p>
+  <div id="M000985_source" class="dyn-source">
+<pre>
+<span class="ruby-comment cmt"># File lib/more/facets/filter.rb, line 62</span>
+    <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">select</span>
+      <span class="ruby-constant">Enumerator</span><span class="ruby-operator">::</span><span class="ruby-constant">Filter</span>.<span class="ruby-identifier">new</span> <span class="ruby-keyword kw">do</span> <span class="ruby-operator">|</span><span class="ruby-identifier">output</span><span class="ruby-operator">|</span>
+        <span class="ruby-identifier">each</span> <span class="ruby-keyword kw">do</span> <span class="ruby-operator">|</span><span class="ruby-operator">*</span><span class="ruby-identifier">input</span><span class="ruby-operator">|</span>
+          <span class="ruby-identifier">output</span>.<span class="ruby-identifier">yield</span>(<span class="ruby-operator">*</span><span class="ruby-identifier">input</span>) <span class="ruby-keyword kw">if</span> <span class="ruby-keyword kw">yield</span>(<span class="ruby-operator">*</span><span class="ruby-identifier">input</span>)
+        <span class="ruby-keyword kw">end</span>
+      <span class="ruby-keyword kw">end</span>
+    <span class="ruby-keyword kw">end</span>
+</pre>
+  </div>
+</div>
+</div>
+<div class="method">
+  <div class="title">
+    <a name="M000989"></a><b>skip</b>(n)
+  </div>
+  <div class="description">
+  <p>
+Skip the first n items in the list
+</p>
+  </div>
+<div class="sourcecode">
+  <p class="source-link">[ <a href="javascript:toggleSource('M000989_source')" id="l_M000989_source">+</a> ]</p>
+  <div id="M000989_source" class="dyn-source">
+<pre>
+<span class="ruby-comment cmt"># File lib/more/facets/filter.rb, line 94</span>
+    <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">skip</span>(<span class="ruby-identifier">n</span>)
+      <span class="ruby-constant">Enumerator</span><span class="ruby-operator">::</span><span class="ruby-constant">Filter</span>.<span class="ruby-identifier">new</span> <span class="ruby-keyword kw">do</span> <span class="ruby-operator">|</span><span class="ruby-identifier">output</span><span class="ruby-operator">|</span>
+        <span class="ruby-identifier">count</span> = <span class="ruby-value">0</span>
+        <span class="ruby-identifier">each</span> <span class="ruby-keyword kw">do</span> <span class="ruby-operator">|</span><span class="ruby-operator">*</span><span class="ruby-identifier">input</span><span class="ruby-operator">|</span>
+          <span class="ruby-identifier">output</span>.<span class="ruby-identifier">yield</span>(<span class="ruby-operator">*</span><span class="ruby-identifier">input</span>) <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">count</span> <span class="ruby-operator">&gt;=</span> <span class="ruby-identifier">n</span>
+          <span class="ruby-identifier">count</span> <span class="ruby-operator">+=</span> <span class="ruby-value">1</span>
+        <span class="ruby-keyword kw">end</span>
+      <span class="ruby-keyword kw">end</span>
+    <span class="ruby-keyword kw">end</span>
+</pre>
+  </div>
+</div>
+</div>
+<div class="method">
+  <div class="title">
+    <a name="M000988"></a><b>take</b>(n)
+  </div>
+  <div class="description">
+  <p>
+Limit to the first n items in the list
+</p>
+  </div>
+<div class="sourcecode">
+  <p class="source-link">[ <a href="javascript:toggleSource('M000988_source')" id="l_M000988_source">+</a> ]</p>
+  <div id="M000988_source" class="dyn-source">
+<pre>
+<span class="ruby-comment cmt"># File lib/more/facets/filter.rb, line 81</span>
+    <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">take</span>(<span class="ruby-identifier">n</span>)
+      <span class="ruby-constant">Enumerator</span><span class="ruby-operator">::</span><span class="ruby-constant">Filter</span>.<span class="ruby-identifier">new</span> <span class="ruby-keyword kw">do</span> <span class="ruby-operator">|</span><span class="ruby-identifier">output</span><span class="ruby-operator">|</span>
+        <span class="ruby-identifier">count</span> = <span class="ruby-value">0</span>
+        <span class="ruby-identifier">each</span> <span class="ruby-keyword kw">do</span> <span class="ruby-operator">|</span><span class="ruby-operator">*</span><span class="ruby-identifier">input</span><span class="ruby-operator">|</span>
+          <span class="ruby-keyword kw">break</span> <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">count</span> <span class="ruby-operator">&gt;=</span> <span class="ruby-identifier">n</span>
+          <span class="ruby-identifier">output</span>.<span class="ruby-identifier">yield</span>(<span class="ruby-operator">*</span><span class="ruby-identifier">input</span>)
+          <span class="ruby-identifier">count</span> <span class="ruby-operator">+=</span> <span class="ruby-value">1</span>
+        <span class="ruby-keyword kw">end</span>
+      <span class="ruby-keyword kw">end</span>
+    <span class="ruby-keyword kw">end</span>
+</pre>
+  </div>
+</div>
+</div>
+</div>
+
+  </div>
+
+    </body>
+</html>