facets 2.4.5 → 2.5.0

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

@@ -58,6 +58,7 @@
         <td>In:</td>
         <td>
 <a href="../files/lib/core/facets/to_hash_rb.html">lib/core/facets/to_hash.rb</a>
+<a href="../files/lib/core/facets/enumerable/take_rb.html">lib/core/facets/enumerable/take.rb</a>
 <a href="../files/lib/core/facets/enumerable/one_rb.html">lib/core/facets/enumerable/one.rb</a>
 <a href="../files/lib/core/facets/enumerable/cluster_by_rb.html">lib/core/facets/enumerable/cluster_by.rb</a>
 <a href="../files/lib/core/facets/enumerable/group_by_rb.html">lib/core/facets/enumerable/group_by.rb</a>
@@ -96,36 +97,37 @@
 
 
   <div class="sectiontitle">Methods</div>
-  <span style="padding-right: 5px;"><a href="#M000428">accumulate</a></span>
-  <span style="padding-right: 5px;"><a href="#M000411">cluster_by</a></span>
-  <span style="padding-right: 5px;"><a href="#M000417">collect_with_index</a></span>
-  <span style="padding-right: 5px;"><a href="#M000415">commonality</a></span>
-  <span style="padding-right: 5px;"><a href="#M000420">compact_collect</a></span>
-  <span style="padding-right: 5px;"><a href="#M000419">compact_map</a></span>
-  <span style="padding-right: 5px;"><a href="#M000437">count</a></span>
-  <span style="padding-right: 5px;"><a href="#M000422">divide</a></span>
-  <span style="padding-right: 5px;"><a href="#M000425">duplicates</a></span>
-  <span style="padding-right: 5px;"><a href="#M000438">each_by</a></span>
-  <span style="padding-right: 5px;"><a href="#M000432">entropy</a></span>
-  <span style="padding-right: 5px;"><a href="#M000421">frequency</a></span>
-  <span style="padding-right: 5px;"><a href="#M000430">graph</a></span>
-  <span style="padding-right: 5px;"><a href="#M000412">group_by</a></span>
-  <span style="padding-right: 5px;"><a href="#M000433">ideal_entropy</a></span>
-  <span style="padding-right: 5px;"><a href="#M000423">inject!</a></span>
-  <span style="padding-right: 5px;"><a href="#M000435">map_send</a></span>
-  <span style="padding-right: 5px;"><a href="#M000418">map_with_index</a></span>
-  <span style="padding-right: 5px;"><a href="#M000429">mash</a></span>
-  <span style="padding-right: 5px;"><a href="#M000414">mode</a></span>
-  <span style="padding-right: 5px;"><a href="#M000431">modulate</a></span>
-  <span style="padding-right: 5px;"><a href="#M000426">none?</a></span>
-  <span style="padding-right: 5px;"><a href="#M000424">nonuniq</a></span>
-  <span style="padding-right: 5px;"><a href="#M000416">occur</a></span>
-  <span style="padding-right: 5px;"><a href="#M000410">one?</a></span>
-  <span style="padding-right: 5px;"><a href="#M000436">probability</a></span>
-  <span style="padding-right: 5px;"><a href="#M000434">split</a></span>
-  <span style="padding-right: 5px;"><a href="#M000413">sum</a></span>
-  <span style="padding-right: 5px;"><a href="#M000409">to_h</a></span>
-  <span style="padding-right: 5px;"><a href="#M000427">uniq_by</a></span>
+  <span style="padding-right: 5px;"><a href="#M000435">accumulate</a></span>
+  <span style="padding-right: 5px;"><a href="#M000418">cluster_by</a></span>
+  <span style="padding-right: 5px;"><a href="#M000424">collect_with_index</a></span>
+  <span style="padding-right: 5px;"><a href="#M000422">commonality</a></span>
+  <span style="padding-right: 5px;"><a href="#M000427">compact_collect</a></span>
+  <span style="padding-right: 5px;"><a href="#M000426">compact_map</a></span>
+  <span style="padding-right: 5px;"><a href="#M000444">count</a></span>
+  <span style="padding-right: 5px;"><a href="#M000429">divide</a></span>
+  <span style="padding-right: 5px;"><a href="#M000432">duplicates</a></span>
+  <span style="padding-right: 5px;"><a href="#M000445">each_by</a></span>
+  <span style="padding-right: 5px;"><a href="#M000439">entropy</a></span>
+  <span style="padding-right: 5px;"><a href="#M000428">frequency</a></span>
+  <span style="padding-right: 5px;"><a href="#M000437">graph</a></span>
+  <span style="padding-right: 5px;"><a href="#M000419">group_by</a></span>
+  <span style="padding-right: 5px;"><a href="#M000440">ideal_entropy</a></span>
+  <span style="padding-right: 5px;"><a href="#M000430">inject!</a></span>
+  <span style="padding-right: 5px;"><a href="#M000442">map_send</a></span>
+  <span style="padding-right: 5px;"><a href="#M000425">map_with_index</a></span>
+  <span style="padding-right: 5px;"><a href="#M000436">mash</a></span>
+  <span style="padding-right: 5px;"><a href="#M000421">mode</a></span>
+  <span style="padding-right: 5px;"><a href="#M000438">modulate</a></span>
+  <span style="padding-right: 5px;"><a href="#M000433">none?</a></span>
+  <span style="padding-right: 5px;"><a href="#M000431">nonuniq</a></span>
+  <span style="padding-right: 5px;"><a href="#M000423">occur</a></span>
+  <span style="padding-right: 5px;"><a href="#M000417">one?</a></span>
+  <span style="padding-right: 5px;"><a href="#M000443">probability</a></span>
+  <span style="padding-right: 5px;"><a href="#M000441">split</a></span>
+  <span style="padding-right: 5px;"><a href="#M000420">sum</a></span>
+  <span style="padding-right: 5px;"><a href="#M000416">take</a></span>
+  <span style="padding-right: 5px;"><a href="#M000415">to_h</a></span>
+  <span style="padding-right: 5px;"><a href="#M000434">uniq_by</a></span>
 
 
 
@@ -135,7 +137,7 @@
 <div class="sectiontitle">Public Instance methods</div>
 <div class="method">
   <div class="title">
-    <a name="M000428"></a><b>accumulate</b>()
+    <a name="M000435"></a><b>accumulate</b>()
   </div>
   <div class="description">
   <p>
@@ -149,13 +151,16 @@ For example, in an ORM design if Group has_many User then
 </pre>
 <p>
 will return a list of users from all groups.
+</p>
+<p>
+CREDIT: George Moshchovitis
 </p>
   </div>
 <div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000428_source')" id="l_M000428_source">+</a> ]</p>
-  <div id="M000428_source" class="dyn-source">
+  <p class="source-link">[ <a href="javascript:toggleSource('M000435_source')" id="l_M000435_source">+</a> ]</p>
+  <div id="M000435_source" class="dyn-source">
 <pre>
-<span class="ruby-comment cmt"># File lib/core/facets/enumerable/accumulate.rb, line 14</span>
+<span class="ruby-comment cmt"># File lib/core/facets/enumerable/accumulate.rb, line 16</span>
   <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">accumulate</span>
     <span class="ruby-ivar">@_accumulate</span> <span class="ruby-operator">||=</span> <span class="ruby-constant">Functor</span>.<span class="ruby-identifier">new</span> <span class="ruby-keyword kw">do</span> <span class="ruby-operator">|</span><span class="ruby-identifier">op</span>, <span class="ruby-operator">*</span><span class="ruby-identifier">args</span><span class="ruby-operator">|</span>
       <span class="ruby-identifier">inject</span>([]) { <span class="ruby-operator">|</span><span class="ruby-identifier">a</span>, <span class="ruby-identifier">x</span><span class="ruby-operator">|</span> <span class="ruby-identifier">a</span> <span class="ruby-operator">&lt;&lt;</span> <span class="ruby-identifier">x</span>.<span class="ruby-identifier">send</span>(<span class="ruby-identifier">op</span>, <span class="ruby-operator">*</span><span class="ruby-identifier">args</span>) }.<span class="ruby-identifier">flatten</span>
@@ -167,11 +172,11 @@ will return a list of users from all groups.
 </div>
 <div class="method">
   <div class="title">
-    <a name="M000411"></a><b>cluster_by</b>(&amp;b)
+    <a name="M000418"></a><b>cluster_by</b>(&amp;b)
   </div>
   <div class="description">
   <p>
-Similar to <a href="Enumerable.html#M000412">group_by</a> but returns an
+Similar to <a href="Enumerable.html#M000419">group_by</a> but returns an
 array of the groups. Returned elements are sorted by block.
 </p>
 <pre>
@@ -182,13 +187,14 @@ array of the groups. Returned elements are sorted by block.
 </p>
 <pre>
    [ ['a'], ['is'], ['this', 'test'] ]
-
- CREDIT Erik Veenstra
 </pre>
+<p>
+CREDIT: Erik Veenstra
+</p>
   </div>
 <div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000411_source')" id="l_M000411_source">+</a> ]</p>
-  <div id="M000411_source" class="dyn-source">
+  <p class="source-link">[ <a href="javascript:toggleSource('M000418_source')" id="l_M000418_source">+</a> ]</p>
+  <div id="M000418_source" class="dyn-source">
 <pre>
 <span class="ruby-comment cmt"># File lib/core/facets/enumerable/cluster_by.rb, line 16</span>
   <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">cluster_by</span>(<span class="ruby-operator">&amp;</span><span class="ruby-identifier">b</span>)
@@ -200,7 +206,7 @@ array of the groups. Returned elements are sorted by block.
 </div>
 <div class="method">
   <div class="title">
-    <a name="M000417"></a><b>collect_with_index</b>() {|self[i], i| ...}
+    <a name="M000424"></a><b>collect_with_index</b>() {|self[i], i| ...}
   </div>
   <div class="description">
   <p>
@@ -209,17 +215,18 @@ Same as collect but with an iteration counter.
 <pre>
   a = [1,2,3].collect_with_index { |e,i| e*i }
   a  #=&gt; [0,2,6]
-
-  CREDIT: Gavin Sinclair
 </pre>
+<p>
+CREDIT: Gavin Sinclair
+</p>
   </div>
 <div class="aka">
   This method is also aliased as
-  <a href="Enumerable.html#M000418">map_with_index</a>
+  <a href="Enumerable.html#M000425">map_with_index</a>
 </div>
 <div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000417_source')" id="l_M000417_source">+</a> ]</p>
-  <div id="M000417_source" class="dyn-source">
+  <p class="source-link">[ <a href="javascript:toggleSource('M000424_source')" id="l_M000424_source">+</a> ]</p>
+  <div id="M000424_source" class="dyn-source">
 <pre>
 <span class="ruby-comment cmt"># File lib/core/facets/enumerable/collect.rb, line 10</span>
   <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">collect_with_index</span>
@@ -235,7 +242,7 @@ Same as collect but with an iteration counter.
 </div>
 <div class="method">
   <div class="title">
-    <a name="M000415"></a><b>commonality</b>( &amp;block )
+    <a name="M000422"></a><b>commonality</b>( &amp;block )
   </div>
   <div class="description">
   <p>
@@ -251,13 +258,14 @@ value for Object#hash and if obj1 == obj2.
 
   # Returns all persons that share their last name with another person.
   persons.collisions { |person| person.last_name }
-
-  CREDIT: Florian Gross
 </pre>
+<p>
+CREDIT: Florian Gross
+</p>
   </div>
 <div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000415_source')" id="l_M000415_source">+</a> ]</p>
-  <div id="M000415_source" class="dyn-source">
+  <p class="source-link">[ <a href="javascript:toggleSource('M000422_source')" id="l_M000422_source">+</a> ]</p>
+  <div id="M000422_source" class="dyn-source">
 <pre>
 <span class="ruby-comment cmt"># File lib/core/facets/enumerable/commonality.rb, line 17</span>
   <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">commonality</span>( <span class="ruby-operator">&amp;</span><span class="ruby-identifier">block</span> )
@@ -280,17 +288,17 @@ value for Object#hash and if obj1 == obj2.
 </div>
 <div class="method">
   <div class="title">
-    <a name="M000420"></a><b>compact_collect</b>(trash=nil, &amp;block)
+    <a name="M000427"></a><b>compact_collect</b>(trash=nil, &amp;block)
   </div>
   <div class="description">
   <p>
-Alias for <a href="Enumerable.html#M000419">compact_map</a>
+Alias for <a href="Enumerable.html#M000426">compact_map</a>
 </p>
   </div>
 </div>
 <div class="method">
   <div class="title">
-    <a name="M000419"></a><b>compact_map</b>(trash=nil) {|*a| ...}
+    <a name="M000426"></a><b>compact_map</b>(trash=nil) {|*a| ...}
   </div>
   <div class="description">
   <p>
@@ -311,17 +319,17 @@ out in one single step.
 <p>
 NOTE: Perhaps nicer to have as added functionality for compact.
 </p>
-<pre>
- CREDIT: Trans
-</pre>
+<p>
+CREDIT: Trans
+</p>
   </div>
 <div class="aka">
   This method is also aliased as
-  <a href="Enumerable.html#M000420">compact_collect</a>
+  <a href="Enumerable.html#M000427">compact_collect</a>
 </div>
 <div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000419_source')" id="l_M000419_source">+</a> ]</p>
-  <div id="M000419_source" class="dyn-source">
+  <p class="source-link">[ <a href="javascript:toggleSource('M000426_source')" id="l_M000426_source">+</a> ]</p>
+  <div id="M000426_source" class="dyn-source">
 <pre>
 <span class="ruby-comment cmt"># File lib/core/facets/enumerable/collect.rb, line 37</span>
   <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">compact_map</span>(<span class="ruby-identifier">trash</span>=<span class="ruby-keyword kw">nil</span>, <span class="ruby-operator">&amp;</span><span class="ruby-identifier">block</span>)
@@ -344,7 +352,7 @@ NOTE: Perhaps nicer to have as added functionality for compact.
 </div>
 <div class="method">
   <div class="title">
-    <a name="M000437"></a><b>count</b>(*c)
+    <a name="M000444"></a><b>count</b>(*c)
   </div>
   <div class="description">
   <p>
@@ -361,13 +369,14 @@ Count can also handle multiple-valued blocks.
 <pre>
   e = { 'a' =&gt; 2, 'a' =&gt; 2, 'b' =&gt; 1 }
   e.count('a',2)  #=&gt; 1
-
-  CREDIT: Trans
 </pre>
+<p>
+CREDIT: Trans
+</p>
   </div>
 <div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000437_source')" id="l_M000437_source">+</a> ]</p>
-  <div id="M000437_source" class="dyn-source">
+  <p class="source-link">[ <a href="javascript:toggleSource('M000444_source')" id="l_M000444_source">+</a> ]</p>
+  <div id="M000444_source" class="dyn-source">
 <pre>
 <span class="ruby-comment cmt"># File lib/core/facets/enumerable/count.rb, line 19</span>
     <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">count</span>(<span class="ruby-operator">*</span><span class="ruby-identifier">c</span>)
@@ -379,7 +388,7 @@ Count can also handle multiple-valued blocks.
 </div>
 <div class="method">
   <div class="title">
-    <a name="M000422"></a><b>divide</b>(pattern)
+    <a name="M000429"></a><b>divide</b>(pattern)
   </div>
   <div class="description">
   <p>
@@ -388,13 +397,14 @@ Divide on matching pattern.
 <pre>
   ['a1','b1','a2','b2'].divide(/^a/)
   =&gt; [['a1,'b1'],['a2','b2']]
-
- CREDIT: Trans
 </pre>
+<p>
+CREDIT: Trans
+</p>
   </div>
 <div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000422_source')" id="l_M000422_source">+</a> ]</p>
-  <div id="M000422_source" class="dyn-source">
+  <p class="source-link">[ <a href="javascript:toggleSource('M000429_source')" id="l_M000429_source">+</a> ]</p>
+  <div id="M000429_source" class="dyn-source">
 <pre>
 <span class="ruby-comment cmt"># File lib/core/facets/enumerable/divide.rb, line 10</span>
   <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">divide</span>(<span class="ruby-identifier">pattern</span>)
@@ -411,17 +421,17 @@ Divide on matching pattern.
 </div>
 <div class="method">
   <div class="title">
-    <a name="M000425"></a><b>duplicates</b>()
+    <a name="M000432"></a><b>duplicates</b>()
   </div>
   <div class="description">
   <p>
-Alias for <a href="Enumerable.html#M000424">nonuniq</a>
+Alias for <a href="Enumerable.html#M000431">nonuniq</a>
 </p>
   </div>
 </div>
 <div class="method">
   <div class="title">
-    <a name="M000438"></a><b>each_by</b>(steps=nil, &amp;block)
+    <a name="M000445"></a><b>each_by</b>(steps=nil, &amp;block)
   </div>
   <div class="description">
   <p>
@@ -441,13 +451,13 @@ the block is used.
 This is just like each_slice, except that it will check the arity of the
 block. If each_slice ever suppots this this method can be deprecated.
 </p>
-<pre>
- CREDIT: Trans
-</pre>
+<p>
+CREDIT: Trans
+</p>
   </div>
 <div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000438_source')" id="l_M000438_source">+</a> ]</p>
-  <div id="M000438_source" class="dyn-source">
+  <p class="source-link">[ <a href="javascript:toggleSource('M000445_source')" id="l_M000445_source">+</a> ]</p>
+  <div id="M000445_source" class="dyn-source">
 <pre>
 <span class="ruby-comment cmt"># File lib/core/facets/enumerable/each_by.rb, line 22</span>
   <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">each_by</span>(<span class="ruby-identifier">steps</span>=<span class="ruby-keyword kw">nil</span>, <span class="ruby-operator">&amp;</span><span class="ruby-identifier">block</span>)
@@ -465,24 +475,25 @@ block. If each_slice ever suppots this this method can be deprecated.
 </div>
 <div class="method">
   <div class="title">
-    <a name="M000432"></a><b>entropy</b>()
+    <a name="M000439"></a><b>entropy</b>()
   </div>
   <div class="description">
   <p>
-Shannon&#8216;s <a href="Enumerable.html#M000432">entropy</a> for an array
+Shannon&#8216;s <a href="Enumerable.html#M000439">entropy</a> for an array
 - returns the average bits per symbol required to encode the array. Lower
-values mean less &quot;<a href="Enumerable.html#M000432">entropy</a>&quot;
+values mean less &quot;<a href="Enumerable.html#M000439">entropy</a>&quot;
 - i.e. less unique information in the array.
 </p>
 <pre>
   %w{ a b c d e e e }.entropy  #=&gt;
-
-  CREDIT: Derek
 </pre>
+<p>
+CREDIT: Derek
+</p>
   </div>
 <div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000432_source')" id="l_M000432_source">+</a> ]</p>
-  <div id="M000432_source" class="dyn-source">
+  <p class="source-link">[ <a href="javascript:toggleSource('M000439_source')" id="l_M000439_source">+</a> ]</p>
+  <div id="M000439_source" class="dyn-source">
 <pre>
 <span class="ruby-comment cmt"># File lib/core/facets/enumerable/entropy.rb, line 14</span>
   <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">entropy</span>
@@ -500,20 +511,20 @@ values mean less &quot;<a href="Enumerable.html#M000432">entropy</a>&quot;
 </div>
 <div class="method">
   <div class="title">
-    <a name="M000421"></a><b>frequency</b>()
+    <a name="M000428"></a><b>frequency</b>()
   </div>
   <div class="description">
   <p>
 Generates a hash mapping each unique symbol in the array to the absolute <a
-href="Enumerable.html#M000421">frequency</a> it appears.
+href="Enumerable.html#M000428">frequency</a> it appears.
+</p>
+<p>
+CREDIT: Brian Schröder
 </p>
-<pre>
- CREDIT: Brian Schröder
-</pre>
   </div>
 <div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000421_source')" id="l_M000421_source">+</a> ]</p>
-  <div id="M000421_source" class="dyn-source">
+  <p class="source-link">[ <a href="javascript:toggleSource('M000428_source')" id="l_M000428_source">+</a> ]</p>
+  <div id="M000428_source" class="dyn-source">
 <pre>
 <span class="ruby-comment cmt"># File lib/core/facets/enumerable/frequency.rb, line 8</span>
   <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">frequency</span>
@@ -530,21 +541,21 @@ href="Enumerable.html#M000421">frequency</a> it appears.
 </div>
 <div class="method">
   <div class="title">
-    <a name="M000430"></a><b>graph</b>(&amp;yld)
+    <a name="M000437"></a><b>graph</b>(&amp;yld)
   </div>
   <div class="description">
   <p>
-Alias for <a href="Enumerable.html#M000429">mash</a>
+Alias for <a href="Enumerable.html#M000436">mash</a>
 </p>
   </div>
 </div>
 <div class="method">
   <div class="title">
-    <a name="M000412"></a><b>group_by</b>( {|| ...}
+    <a name="M000419"></a><b>group_by</b>( {|| ...}
   </div>
   <div class="description">
   <p>
-<a href="Enumerable.html#M000412">group_by</a> is used to group items in a
+<a href="Enumerable.html#M000419">group_by</a> is used to group items in a
 collection by something they have in common. The common factor is the key
 in the resulting hash, the array of like elements is the value.
 </p>
@@ -554,13 +565,14 @@ in the resulting hash, the array of like elements is the value.
 
   [&quot;I had&quot;, 1, &quot;dollar and&quot;, 50, &quot;cents&quot;].group_by { |e| e.class }
        #=&gt; { String =&gt; [&quot;I had&quot;,&quot;dollar and&quot;,&quot;cents&quot;], Fixnum =&gt; [1,50] }
-
- CREDIT: Erik Veenstra
 </pre>
+<p>
+CREDIT: Erik Veenstra
+</p>
   </div>
 <div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000412_source')" id="l_M000412_source">+</a> ]</p>
-  <div id="M000412_source" class="dyn-source">
+  <p class="source-link">[ <a href="javascript:toggleSource('M000419_source')" id="l_M000419_source">+</a> ]</p>
+  <div id="M000419_source" class="dyn-source">
 <pre>
 <span class="ruby-comment cmt"># File lib/core/facets/enumerable/group_by.rb, line 17</span>
     <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">group_by</span> <span class="ruby-comment cmt">#:yield:</span>
@@ -575,22 +587,22 @@ in the resulting hash, the array of like elements is the value.
 </div>
 <div class="method">
   <div class="title">
-    <a name="M000433"></a><b>ideal_entropy</b>()
+    <a name="M000440"></a><b>ideal_entropy</b>()
   </div>
   <div class="description">
   <p>
 Returns the maximum possible Shannon <a
-href="Enumerable.html#M000432">entropy</a> of the array with given size
+href="Enumerable.html#M000439">entropy</a> of the array with given size
 assuming that it is an &quot;order-0&quot; source (each element is selected
 independently of the next).
 </p>
-<pre>
-  CREDIT: Derek
-</pre>
+<p>
+CREDIT: Derek
+</p>
   </div>
 <div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000433_source')" id="l_M000433_source">+</a> ]</p>
-  <div id="M000433_source" class="dyn-source">
+  <p class="source-link">[ <a href="javascript:toggleSource('M000440_source')" id="l_M000440_source">+</a> ]</p>
+  <div id="M000440_source" class="dyn-source">
 <pre>
 <span class="ruby-comment cmt"># File lib/core/facets/enumerable/entropy.rb, line 30</span>
   <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">ideal_entropy</span>
@@ -604,7 +616,7 @@ independently of the next).
 </div>
 <div class="method">
   <div class="title">
-    <a name="M000423"></a><b>inject!</b>(s) {|k, i| ...}
+    <a name="M000430"></a><b>inject!</b>(s) {|k, i| ...}
   </div>
   <div class="description">
   <p>
@@ -612,7 +624,7 @@ A small variation of Inject that save one from having to return the
 aggregating or memo argument.
 </p>
 <p>
-Say you want to <a href="Enumerable.html#M000437">count</a> letters.
+Say you want to <a href="Enumerable.html#M000444">count</a> letters.
 </p>
 <pre>
    some_text.inject!(Hash.new(0)) {|h,l| h[l] += 1}
@@ -622,16 +634,16 @@ vs
 </p>
 <pre>
    some_text.inject(Hash.new(0)) {|h,l| h[l] +=1; h}
-
- CREDIT: David Black
- CREDIT: Louis J Scoras
 </pre>
+<p>
+CREDIT: David Black, Louis J Scoras
+</p>
   </div>
 <div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000423_source')" id="l_M000423_source">+</a> ]</p>
-  <div id="M000423_source" class="dyn-source">
+  <p class="source-link">[ <a href="javascript:toggleSource('M000430_source')" id="l_M000430_source">+</a> ]</p>
+  <div id="M000430_source" class="dyn-source">
 <pre>
-<span class="ruby-comment cmt"># File lib/core/facets/enumerable/inject.rb, line 17</span>
+<span class="ruby-comment cmt"># File lib/core/facets/enumerable/inject.rb, line 16</span>
   <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">inject!</span>(<span class="ruby-identifier">s</span>)
     <span class="ruby-identifier">k</span> = <span class="ruby-identifier">s</span>
     <span class="ruby-identifier">each</span> { <span class="ruby-operator">|</span><span class="ruby-identifier">i</span><span class="ruby-operator">|</span> <span class="ruby-keyword kw">yield</span>(<span class="ruby-identifier">k</span>, <span class="ruby-identifier">i</span>) }
@@ -643,19 +655,19 @@ vs
 </div>
 <div class="method">
   <div class="title">
-    <a name="M000435"></a><b>map_send</b>(meth, *args, &amp;block)
+    <a name="M000442"></a><b>map_send</b>(meth, *args, &amp;block)
   </div>
   <div class="description">
   <p>
 Send a message to each element and collect the result.
 </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('M000435_source')" id="l_M000435_source">+</a> ]</p>
-  <div id="M000435_source" class="dyn-source">
+  <p class="source-link">[ <a href="javascript:toggleSource('M000442_source')" id="l_M000442_source">+</a> ]</p>
+  <div id="M000442_source" class="dyn-source">
 <pre>
 <span class="ruby-comment cmt"># File lib/core/facets/enumerable/map_send.rb, line 7</span>
   <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">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>)
@@ -667,17 +679,17 @@ Send a message to each element and collect the result.
 </div>
 <div class="method">
   <div class="title">
-    <a name="M000418"></a><b>map_with_index</b>()
+    <a name="M000425"></a><b>map_with_index</b>()
   </div>
   <div class="description">
   <p>
-Alias for <a href="Enumerable.html#M000417">collect_with_index</a>
+Alias for <a href="Enumerable.html#M000424">collect_with_index</a>
 </p>
   </div>
 </div>
 <div class="method">
   <div class="title">
-    <a name="M000429"></a><b>mash</b>(&amp;yld)
+    <a name="M000436"></a><b>mash</b>(&amp;yld)
   </div>
   <div class="description">
   <p>
@@ -691,21 +703,22 @@ key and the value for the new hash.
   sq_roots = numbers.mash { |n| [n*n, n] }   # { 1=&gt;1, 4=&gt;2, 9=&gt;3 }
 </pre>
 <p>
-CREDIT: Trans CREDIT: Andrew Dudzik (adudzik)
+The name &quot;<a href="Enumerable.html#M000436">mash</a>&quot; stands for
+&quot;map hash&quot;.
 </p>
 <p>
-NOTE: Would correlate would be better?
+CREDIT: Andrew Dudzik (adudzik), Trans
 </p>
   </div>
 <div class="aka">
   This method is also aliased as
-  <a href="Enumerable.html#M000430">graph</a>
+  <a href="Enumerable.html#M000437">graph</a>
 </div>
 <div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000429_source')" id="l_M000429_source">+</a> ]</p>
-  <div id="M000429_source" class="dyn-source">
+  <p class="source-link">[ <a href="javascript:toggleSource('M000436_source')" id="l_M000436_source">+</a> ]</p>
+  <div id="M000436_source" class="dyn-source">
 <pre>
-<span class="ruby-comment cmt"># File lib/core/facets/enumerable/mash.rb, line 15</span>
+<span class="ruby-comment cmt"># File lib/core/facets/enumerable/mash.rb, line 14</span>
   <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">mash</span>(<span class="ruby-operator">&amp;</span><span class="ruby-identifier">yld</span>)
     <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">yld</span>
       <span class="ruby-identifier">inject</span>({}) <span class="ruby-keyword kw">do</span> <span class="ruby-operator">|</span><span class="ruby-identifier">h</span>, <span class="ruby-operator">*</span><span class="ruby-identifier">kv</span><span class="ruby-operator">|</span> <span class="ruby-comment cmt"># Used to be inject({}) do |h,kv|</span>
@@ -724,20 +737,20 @@ NOTE: Would correlate would be better?
 </div>
 <div class="method">
   <div class="title">
-    <a name="M000414"></a><b>mode</b>()
+    <a name="M000421"></a><b>mode</b>()
   </div>
   <div class="description">
   <p>
-In Statistics <a href="Enumerable.html#M000414">mode</a> is the value that
+In Statistics <a href="Enumerable.html#M000421">mode</a> is the value that
 occurs most frequently in a given set of data.
 </p>
-<pre>
- CREDIT: Robert Klemme
-</pre>
+<p>
+CREDIT: Robert Klemme
+</p>
   </div>
 <div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000414_source')" id="l_M000414_source">+</a> ]</p>
-  <div id="M000414_source" class="dyn-source">
+  <p class="source-link">[ <a href="javascript:toggleSource('M000421_source')" id="l_M000421_source">+</a> ]</p>
+  <div id="M000421_source" class="dyn-source">
 <pre>
 <span class="ruby-comment cmt"># File lib/core/facets/enumerable/mode.rb, line 8</span>
   <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">mode</span>
@@ -752,26 +765,26 @@ occurs most frequently in a given set of data.
 </div>
 <div class="method">
   <div class="title">
-    <a name="M000431"></a><b>modulate</b>(modulo)
+    <a name="M000438"></a><b>modulate</b>(modulo)
   </div>
   <div class="description">
   <p>
 Modulate. Divide an array into groups by modulo of the index.
 </p>
 <p>
-[2,4,6,8].<a href="Enumerable.html#M000431">modulate</a>(2) #=&gt;
+[2,4,6,8].<a href="Enumerable.html#M000438">modulate</a>(2) #=&gt;
 [[2,6],[4,8]]
 </p>
-<pre>
- CREDIT: Trans
-</pre>
 <p>
-NOTE: Would this be better named &#8216;collate&#8217;?
+CREDIT: Trans
+</p>
+<p>
+NOTE: Would the better name for this be &#8216;collate&#8217;?
 </p>
   </div>
 <div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000431_source')" id="l_M000431_source">+</a> ]</p>
-  <div id="M000431_source" class="dyn-source">
+  <p class="source-link">[ <a href="javascript:toggleSource('M000438_source')" id="l_M000438_source">+</a> ]</p>
+  <div id="M000438_source" class="dyn-source">
 <pre>
 <span class="ruby-comment cmt"># File lib/core/facets/enumerable/modulate.rb, line 11</span>
   <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">modulate</span>(<span class="ruby-identifier">modulo</span>)
@@ -789,7 +802,7 @@ NOTE: Would this be better named &#8216;collate&#8217;?
 </div>
 <div class="method">
   <div class="title">
-    <a name="M000426"></a><b>none?</b>( {|e| ...}
+    <a name="M000433"></a><b>none?</b>( {|e| ...}
   </div>
   <div class="description">
   <p>
@@ -808,13 +821,14 @@ only if <em>none</em> of the elements have a true value (i.e. not
   [5,8,9].none?                 # false
   (1...10).none? { |n| n &lt; 0 }  # true
   (1...10).none? { |n| n &gt; 0 }  # false
-
-  CREDIT: Gavin Sinclair
 </pre>
+<p>
+CREDIT: Gavin Sinclair
+</p>
   </div>
 <div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000426_source')" id="l_M000426_source">+</a> ]</p>
-  <div id="M000426_source" class="dyn-source">
+  <p class="source-link">[ <a href="javascript:toggleSource('M000433_source')" id="l_M000433_source">+</a> ]</p>
+  <div id="M000433_source" class="dyn-source">
 <pre>
 <span class="ruby-comment cmt"># File lib/core/facets/enumerable/none.rb, line 21</span>
     <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">none?</span>  <span class="ruby-comment cmt"># :yield: e</span>
@@ -830,7 +844,7 @@ only if <em>none</em> of the elements have a true value (i.e. not
 </div>
 <div class="method">
   <div class="title">
-    <a name="M000424"></a><b>nonuniq</b>()
+    <a name="M000431"></a><b>nonuniq</b>()
   </div>
   <div class="description">
   <p>
@@ -838,17 +852,18 @@ Returns a list on non-unique,
 </p>
 <pre>
   [1,1,2,2,3,4,5].nonuniq  #=&gt; [1,2]
-
-  CREDIT: Martin DeMello
 </pre>
+<p>
+CREDIT: Martin DeMello
+</p>
   </div>
 <div class="aka">
   This method is also aliased as
-  <a href="Enumerable.html#M000425">duplicates</a>
+  <a href="Enumerable.html#M000432">duplicates</a>
 </div>
 <div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000424_source')" id="l_M000424_source">+</a> ]</p>
-  <div id="M000424_source" class="dyn-source">
+  <p class="source-link">[ <a href="javascript:toggleSource('M000431_source')" id="l_M000431_source">+</a> ]</p>
+  <div id="M000431_source" class="dyn-source">
 <pre>
 <span class="ruby-comment cmt"># File lib/core/facets/enumerable/duplicates.rb, line 9</span>
   <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">nonuniq</span>
@@ -866,12 +881,12 @@ Returns a list on non-unique,
 </div>
 <div class="method">
   <div class="title">
-    <a name="M000416"></a><b>occur</b>(n=nil) {|| ...}
+    <a name="M000423"></a><b>occur</b>(n=nil) {|| ...}
   </div>
   <div class="description">
   <p>
 Returns an array of elements for the elements that <a
-href="Enumerable.html#M000416">occur</a> n times. Or according to the
+href="Enumerable.html#M000423">occur</a> n times. Or according to the
 results of a given block.
 </p>
 <pre>
@@ -884,15 +899,13 @@ results of a given block.
 
   [1,1,2,3,3,4,5,5].occur { |n| n == 1 } #=&gt; [2,4]
   [1,1,2,3,3,4,5,5].occur { |n| n &gt; 1 }  #=&gt; [1,3,5]
-
-  CREDIT: ?
 </pre>
   </div>
 <div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000416_source')" id="l_M000416_source">+</a> ]</p>
-  <div id="M000416_source" class="dyn-source">
+  <p class="source-link">[ <a href="javascript:toggleSource('M000423_source')" id="l_M000423_source">+</a> ]</p>
+  <div id="M000423_source" class="dyn-source">
 <pre>
-<span class="ruby-comment cmt"># File lib/core/facets/enumerable/occur.rb, line 18</span>
+<span class="ruby-comment cmt"># File lib/core/facets/enumerable/occur.rb, line 16</span>
   <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">occur</span>(<span class="ruby-identifier">n</span>=<span class="ruby-keyword kw">nil</span>) <span class="ruby-comment cmt">#:yield:</span>
     <span class="ruby-identifier">result</span> = <span class="ruby-constant">Hash</span>.<span class="ruby-identifier">new</span> { <span class="ruby-operator">|</span><span class="ruby-identifier">hash</span>, <span class="ruby-identifier">key</span><span class="ruby-operator">|</span> <span class="ruby-identifier">hash</span>[<span class="ruby-identifier">key</span>] = <span class="ruby-constant">Array</span>.<span class="ruby-identifier">new</span> }
     <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">each</span> <span class="ruby-keyword kw">do</span> <span class="ruby-operator">|</span><span class="ruby-identifier">item</span><span class="ruby-operator">|</span>
@@ -917,7 +930,7 @@ results of a given block.
 </div>
 <div class="method">
   <div class="title">
-    <a name="M000410"></a><b>one?</b>( {|e| ...}
+    <a name="M000417"></a><b>one?</b>( {|e| ...}
   </div>
   <div class="description">
   <p>
@@ -936,13 +949,14 @@ only if <em>exactly one</em> element has a true value (i.e. not
   [5,8,9].one?                 # false
   (1...10).one? { |n| n == 5 } # true
   (1...10).one? { |n| n &lt; 5 }  # false
-
-  CREDIT: Gavin Sinclair
 </pre>
+<p>
+CREDIT: Gavin Sinclair
+</p>
   </div>
 <div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000410_source')" id="l_M000410_source">+</a> ]</p>
-  <div id="M000410_source" class="dyn-source">
+  <p class="source-link">[ <a href="javascript:toggleSource('M000417_source')" id="l_M000417_source">+</a> ]</p>
+  <div id="M000417_source" class="dyn-source">
 <pre>
 <span class="ruby-comment cmt"># File lib/core/facets/enumerable/one.rb, line 21</span>
     <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">one?</span>  <span class="ruby-comment cmt"># :yield: e</span>
@@ -965,21 +979,21 @@ only if <em>exactly one</em> element has a true value (i.e. not
 </div>
 <div class="method">
   <div class="title">
-    <a name="M000436"></a><b>probability</b>()
+    <a name="M000443"></a><b>probability</b>()
   </div>
   <div class="description">
   <p>
 Generates a hash mapping each unique element in the array to the relative
-<a href="Enumerable.html#M000421">frequency</a>, i.e. the probablity, of it
+<a href="Enumerable.html#M000428">frequency</a>, i.e. the probablity, of it
 appearence.
 </p>
-<pre>
-  CREDIT: Brian Schröder
-</pre>
+<p>
+CREDIT: Brian Schröder
+</p>
   </div>
 <div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000436_source')" id="l_M000436_source">+</a> ]</p>
-  <div id="M000436_source" class="dyn-source">
+  <p class="source-link">[ <a href="javascript:toggleSource('M000443_source')" id="l_M000443_source">+</a> ]</p>
+  <div id="M000443_source" class="dyn-source">
 <pre>
 <span class="ruby-comment cmt"># File lib/core/facets/enumerable/probability.rb, line 9</span>
   <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">probability</span>
@@ -998,12 +1012,12 @@ appearence.
 </div>
 <div class="method">
   <div class="title">
-    <a name="M000434"></a><b>split</b>(pattern)
+    <a name="M000441"></a><b>split</b>(pattern)
   </div>
   <div class="description">
   <p>
 Split on matching pattern. Unlike <a
-href="Enumerable.html#M000422">divide</a> this does not include matching
+href="Enumerable.html#M000429">divide</a> this does not include matching
 elements.
 </p>
 <pre>
@@ -1015,8 +1029,8 @@ CREDIT: Trans
 </p>
   </div>
 <div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000434_source')" id="l_M000434_source">+</a> ]</p>
-  <div id="M000434_source" class="dyn-source">
+  <p class="source-link">[ <a href="javascript:toggleSource('M000441_source')" id="l_M000441_source">+</a> ]</p>
+  <div id="M000441_source" class="dyn-source">
 <pre>
 <span class="ruby-comment cmt"># File lib/core/facets/enumerable/split.rb, line 10</span>
   <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">split</span>(<span class="ruby-identifier">pattern</span>)
@@ -1040,11 +1054,11 @@ CREDIT: Trans
 </div>
 <div class="method">
   <div class="title">
-    <a name="M000413"></a><b>sum</b>(identity = 0, &amp;block)
+    <a name="M000420"></a><b>sum</b>(identity = 0, &amp;block)
   </div>
   <div class="description">
   <p>
-Uses #+ to <a href="Enumerable.html#M000413">sum</a> the enumerated
+Uses #+ to <a href="Enumerable.html#M000420">sum</a> the enumerated
 elements.
 </p>
 <pre>
@@ -1053,8 +1067,8 @@ elements.
 </pre>
   </div>
 <div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000413_source')" id="l_M000413_source">+</a> ]</p>
-  <div id="M000413_source" class="dyn-source">
+  <p class="source-link">[ <a href="javascript:toggleSource('M000420_source')" id="l_M000420_source">+</a> ]</p>
+  <div id="M000420_source" class="dyn-source">
 <pre>
 <span class="ruby-comment cmt"># File lib/core/facets/enumerable/sum.rb, line 8</span>
   <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">sum</span>(<span class="ruby-identifier">identity</span> = <span class="ruby-value">0</span>, <span class="ruby-operator">&amp;</span><span class="ruby-identifier">block</span>)
@@ -1070,7 +1084,35 @@ elements.
 </div>
 <div class="method">
   <div class="title">
-    <a name="M000409"></a><b>to_h</b>(arrayed=nil)
+    <a name="M000416"></a><b>take</b>(n)
+  </div>
+  <div class="description">
+  <p>
+Return the first n items from the collection
+</p>
+  </div>
+<div class="sourcecode">
+  <p class="source-link">[ <a href="javascript:toggleSource('M000416_source')" id="l_M000416_source">+</a> ]</p>
+  <div id="M000416_source" class="dyn-source">
+<pre>
+<span class="ruby-comment cmt"># File lib/core/facets/enumerable/take.rb, line 7</span>
+    <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">take</span>(<span class="ruby-identifier">n</span>)
+      <span class="ruby-identifier">res</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-identifier">e</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">res</span> <span class="ruby-operator">&lt;&lt;</span> <span class="ruby-identifier">e</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-identifier">res</span>
+    <span class="ruby-keyword kw">end</span>
+</pre>
+  </div>
+</div>
+</div>
+<div class="method">
+  <div class="title">
+    <a name="M000415"></a><b>to_h</b>(arrayed=nil)
   </div>
   <div class="description">
   <p>
@@ -1082,8 +1124,8 @@ CREDIT: Trans
 </p>
   </div>
 <div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000409_source')" id="l_M000409_source">+</a> ]</p>
-  <div id="M000409_source" class="dyn-source">
+  <p class="source-link">[ <a href="javascript:toggleSource('M000415_source')" id="l_M000415_source">+</a> ]</p>
+  <div id="M000415_source" class="dyn-source">
 <pre>
 <span class="ruby-comment cmt"># File lib/core/facets/to_hash.rb, line 65</span>
   <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">to_h</span>(<span class="ruby-identifier">arrayed</span>=<span class="ruby-keyword kw">nil</span>)
@@ -1095,7 +1137,7 @@ CREDIT: Trans
 </div>
 <div class="method">
   <div class="title">
-    <a name="M000427"></a><b>uniq_by</b>( {|| ...}
+    <a name="M000434"></a><b>uniq_by</b>( {|| ...}
   </div>
   <div class="description">
   <p>
@@ -1109,15 +1151,13 @@ produces
 </p>
 <pre>
   [-5, -4, -3, -2, -1, 0]
-
-  CREDIT: ?
 </pre>
   </div>
 <div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000427_source')" id="l_M000427_source">+</a> ]</p>
-  <div id="M000427_source" class="dyn-source">
+  <p class="source-link">[ <a href="javascript:toggleSource('M000434_source')" id="l_M000434_source">+</a> ]</p>
+  <div id="M000434_source" class="dyn-source">
 <pre>
-<span class="ruby-comment cmt"># File lib/core/facets/enumerable/uniq_by.rb, line 13</span>
+<span class="ruby-comment cmt"># File lib/core/facets/enumerable/uniq_by.rb, line 11</span>
   <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">uniq_by</span> <span class="ruby-comment cmt">#:yield:</span>
     <span class="ruby-identifier">h</span> = {}; <span class="ruby-identifier">inject</span>([]) {<span class="ruby-operator">|</span><span class="ruby-identifier">a</span>,<span class="ruby-identifier">x</span><span class="ruby-operator">|</span> <span class="ruby-identifier">h</span>[<span class="ruby-keyword kw">yield</span>(<span class="ruby-identifier">x</span>)] <span class="ruby-operator">||=</span> <span class="ruby-identifier">a</span> <span class="ruby-operator">&lt;&lt;</span> <span class="ruby-identifier">x</span>}
   <span class="ruby-keyword kw">end</span>