RubyGems - facets - Versions diffs - 2.5.2 → 2.6.0 - Mend

facets 2.5.2 → 2.6.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (677) hide show

data/doc/rdoc/core/classes/Array.html DELETED

@@ -1,1208 +0,0 @@
-<?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>Class: Array</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">Class</span><br />Array</td>
-  <td align="right">
-    <table cellspacing="0" cellpadding="2">
-      <tr valign="top">
-        <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/boolean_rb.html">lib/core/facets/boolean.rb</a>
-<a href="../files/lib/core/facets/string/contains_rb.html">lib/core/facets/string/contains.rb</a>
-<a href="../files/lib/core/facets/array/product_rb.html">lib/core/facets/array/product.rb</a>
-<a href="../files/lib/core/facets/array/recursively_rb.html">lib/core/facets/array/recursively.rb</a>
-<a href="../files/lib/core/facets/array/not_empty_rb.html">lib/core/facets/array/not_empty.rb</a>
-<a href="../files/lib/core/facets/array/delete_unless_rb.html">lib/core/facets/array/delete_unless.rb</a>
-<a href="../files/lib/core/facets/array/rotate_rb.html">lib/core/facets/array/rotate.rb</a>
-<a href="../files/lib/core/facets/array/conjoin_rb.html">lib/core/facets/array/conjoin.rb</a>
-<a href="../files/lib/core/facets/array/indexable_rb.html">lib/core/facets/array/indexable.rb</a>
-<a href="../files/lib/core/facets/array/merge_rb.html">lib/core/facets/array/merge.rb</a>
-<a href="../files/lib/core/facets/array/traverse_rb.html">lib/core/facets/array/traverse.rb</a>
-<a href="../files/lib/core/facets/array/permutation_rb.html">lib/core/facets/array/permutation.rb</a>
-<a href="../files/lib/core/facets/array/select_rb.html">lib/core/facets/array/select.rb</a>
-<a href="../files/lib/core/facets/array/index_rb.html">lib/core/facets/array/index.rb</a>
-<a href="../files/lib/core/facets/array/only_rb.html">lib/core/facets/array/only.rb</a>
-<a href="../files/lib/core/facets/array/combination_rb.html">lib/core/facets/array/combination.rb</a>
-<a href="../files/lib/core/facets/array/delete_values_rb.html">lib/core/facets/array/delete_values.rb</a>
-<a href="../files/lib/core/facets/array/splice_rb.html">lib/core/facets/array/splice.rb</a>
-<a href="../files/lib/core/facets/array/stackable_rb.html">lib/core/facets/array/stackable.rb</a>
-<a href="../files/lib/core/facets/array/pad_rb.html">lib/core/facets/array/pad.rb</a>
-<a href="../files/lib/core/facets/blank_rb.html">lib/core/facets/blank.rb</a>
-        </td>
-      </tr>
-    <tr>
-      <td>Parent:</td>
-      <td>
-        <a href="Object.html">
-Object
-         </a>
-     </td>
-   </tr>
-         </table>
-        </td>
-        </tr>
-      </table>
- <!-- banner header -->
-  <div id="bodyContent">
-      <div id="content">
-  <div class="sectiontitle">Methods</div>
-  <span style="padding-right: 5px;"><a href="#M000144">**</a></span>
-  <span style="padding-right: 5px;"><a href="#M000159">combination</a></span>
-  <span style="padding-right: 5px;"><a href="#M000151">conjoin</a></span>
-  <span style="padding-right: 5px;"><a href="#M000148">delete_unless</a></span>
-  <span style="padding-right: 5px;"><a href="#M000160">delete_values</a></span>
-  <span style="padding-right: 5px;"><a href="#M000161">delete_values_at</a></span>
-  <span style="padding-right: 5px;"><a href="#M000157">index</a></span>
-  <span style="padding-right: 5px;"><a href="#M000152">merge!</a></span>
-  <span style="padding-right: 5px;"><a href="#M000147">not_empty?</a></span>
-  <span style="padding-right: 5px;"><a href="#M000158">only</a></span>
-  <span style="padding-right: 5px;"><a href="#M000163">pad</a></span>
-  <span style="padding-right: 5px;"><a href="#M000164">pad!</a></span>
-  <span style="padding-right: 5px;"><a href="#M000155">permutation</a></span>
-  <span style="padding-right: 5px;"><a href="#M000143">product</a></span>
-  <span style="padding-right: 5px;"><a href="#M000145">recursively</a></span>
-  <span style="padding-right: 5px;"><a href="#M000146">recursively!</a></span>
-  <span style="padding-right: 5px;"><a href="#M000149">rotate</a></span>
-  <span style="padding-right: 5px;"><a href="#M000150">rotate!</a></span>
-  <span style="padding-right: 5px;"><a href="#M000156">select!</a></span>
-  <span style="padding-right: 5px;"><a href="#M000162">splice</a></span>
-  <span style="padding-right: 5px;"><a href="#M000142">to_b</a></span>
-  <span style="padding-right: 5px;"><a href="#M000136">to_h</a></span>
-  <span style="padding-right: 5px;"><a href="#M000140">to_h_assoc</a></span>
-  <span style="padding-right: 5px;"><a href="#M000137">to_h_auto</a></span>
-  <span style="padding-right: 5px;"><a href="#M000139">to_h_flat</a></span>
-  <span style="padding-right: 5px;"><a href="#M000141">to_h_multi</a></span>
-  <span style="padding-right: 5px;"><a href="#M000138">to_h_splat</a></span>
-  <span style="padding-right: 5px;"><a href="#M000153">traverse</a></span>
-  <span style="padding-right: 5px;"><a href="#M000154">traverse!</a></span>
-<div class="sectiontitle">Included Modules</div>
-<ul>
-  <li><a href="Indexable.html">Indexable</a></li>
-  <li><a href="Stackable.html">Stackable</a></li>
-</ul>
-<div class="sectiontitle">Public Instance methods</div>
-<div class="method">
-  <div class="title">
-    <a name="M000144"></a><b>**</b>(*enums)
-  </div>
-  <div class="description">
-  <p>
-Alias for <a href="Array.html#M000143">product</a>
-</p>
-  </div>
-</div>
-<div class="method">
-  <div class="title">
-    <a name="M000159"></a><b>combination</b>(k=2) {|s.values_at(*idx)| ...}
-  </div>
-  <div class="description">
-  <p>
-Yields the block to each unique <a
-href="Array.html#M000159">combination</a> of <em>n</em> elements.
-</p>
-<pre>
-  a = %w|a b c d|
-  a.combination(3)
-</pre>
-<p>
-produces
-</p>
-<pre>
-  [[&quot;a&quot;, &quot;b&quot;, &quot;c&quot;],
-   [&quot;a&quot;, &quot;b&quot;, &quot;d&quot;],
-   [&quot;a&quot;, &quot;c&quot;, &quot;d&quot;],
-   [&quot;b&quot;, &quot;c&quot;, &quot;d&quot;]]
-</pre>
-<p>
-CREDIT: Florian Gross
-</p>
-  </div>
-<div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000159_source')" id="l_M000159_source">+</a> ]</p>
-  <div id="M000159_source" class="dyn-source">
-<pre>
-<span class="ruby-comment cmt"># File lib/core/facets/array/combination.rb, line 21</span>
-    <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">combination</span>(<span class="ruby-identifier">k</span>=<span class="ruby-value">2</span>)
-      <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">block_given?</span>
-        <span class="ruby-identifier">s</span> = <span class="ruby-identifier">to_a</span>
-        <span class="ruby-identifier">n</span> = <span class="ruby-identifier">s</span>.<span class="ruby-identifier">size</span>
-        <span class="ruby-keyword kw">return</span> <span class="ruby-keyword kw">unless</span> (<span class="ruby-value">1</span><span class="ruby-operator">..</span><span class="ruby-identifier">n</span>) <span class="ruby-operator">===</span> <span class="ruby-identifier">k</span>
-        <span class="ruby-identifier">idx</span> = (<span class="ruby-value">0</span><span class="ruby-operator">...</span><span class="ruby-identifier">k</span>).<span class="ruby-identifier">to_a</span>
-        <span class="ruby-identifier">loop</span> <span class="ruby-keyword kw">do</span>
-          <span class="ruby-keyword kw">yield</span> <span class="ruby-identifier">s</span>.<span class="ruby-identifier">values_at</span>(<span class="ruby-operator">*</span><span class="ruby-identifier">idx</span>)
-          <span class="ruby-identifier">i</span> = <span class="ruby-identifier">k</span> <span class="ruby-operator">-</span> <span class="ruby-value">1</span>
-          <span class="ruby-identifier">i</span> <span class="ruby-operator">-=</span> <span class="ruby-value">1</span> <span class="ruby-keyword kw">while</span> <span class="ruby-identifier">idx</span>[<span class="ruby-identifier">i</span>] <span class="ruby-operator">==</span> <span class="ruby-identifier">n</span> <span class="ruby-operator">-</span> <span class="ruby-identifier">k</span> <span class="ruby-operator">+</span> <span class="ruby-identifier">i</span>
-          <span class="ruby-keyword kw">break</span> <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">i</span> <span class="ruby-operator">&lt;</span> <span class="ruby-value">0</span>
-          <span class="ruby-identifier">idx</span>[<span class="ruby-identifier">i</span>] <span class="ruby-operator">+=</span> <span class="ruby-value">1</span>
-          (<span class="ruby-identifier">i</span> <span class="ruby-operator">+</span> <span class="ruby-value">1</span> <span class="ruby-operator">...</span> <span class="ruby-identifier">k</span>).<span class="ruby-identifier">each</span> {<span class="ruby-operator">|</span><span class="ruby-identifier">j</span><span class="ruby-operator">|</span> <span class="ruby-identifier">idx</span>[<span class="ruby-identifier">j</span>] = <span class="ruby-identifier">idx</span>[<span class="ruby-identifier">i</span>] <span class="ruby-operator">+</span> <span class="ruby-identifier">j</span> <span class="ruby-operator">-</span> <span class="ruby-identifier">i</span>}
-        <span class="ruby-keyword kw">end</span>
-      <span class="ruby-keyword kw">else</span>
-        <span class="ruby-identifier">to_enum</span>(<span class="ruby-identifier">:combination</span>, <span class="ruby-identifier">k</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="M000151"></a><b>conjoin</b>(*args) {|i, *slice(i,2)| ...}
-  </div>
-  <div class="description">
-  <p>
-This is more advnaced form of join. It allows for fine control of
-separators.
-</p>
-<p>
-NOTE: The old version used to default it&#8216;s separator to &quot;,
-&quot; and default the terminating separator to &quot; and &quot;. This is
-no longer the case. You must specifically provide these parameters.
-</p>
-<pre>
-  [1,2,3].conjoin
-  =&gt; &quot;123&quot;
-  [1,2,3].conjoin(', ', ' and ')
-  =&gt; &quot;1, 2 and 3
-  [1,2,3].conjoin(', ', :last =&gt; ' or ')
-  =&gt; &quot;1, 2 or 3
-  [1,2,3].conjoin('; ', -1 =&gt; ' &amp; ')
-  =&gt; &quot;1; 2 &amp; 3
-  [1,2,3,4].conjoin{ |i, a, b| i % 2 == 0 ? '.' : '-' }
-  =&gt; &quot;1.2-3.4&quot;
-  [1,1,2,2].conjoin{ |i, a, b| a == b ? '=' : '!=' }
-  =&gt; &quot;1=1!=2=2&quot;
-</pre>
-<p>
-CREDIT: Trans
-</p>
-  </div>
-<div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000151_source')" id="l_M000151_source">+</a> ]</p>
-  <div id="M000151_source" class="dyn-source">
-<pre>
-<span class="ruby-comment cmt"># File lib/core/facets/array/conjoin.rb, line 30</span>
-  <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">conjoin</span>(<span class="ruby-operator">*</span><span class="ruby-identifier">args</span>, <span class="ruby-operator">&amp;</span><span class="ruby-identifier">block</span>)
-    <span class="ruby-keyword kw">return</span> <span class="ruby-identifier">first</span>.<span class="ruby-identifier">to_s</span> <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">size</span> <span class="ruby-operator">&lt;</span> <span class="ruby-value">2</span>
-    <span class="ruby-identifier">sep</span> = []
-    <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">block_given?</span>
-      (<span class="ruby-identifier">size</span> <span class="ruby-operator">-</span> <span class="ruby-value">1</span>).<span class="ruby-identifier">times</span> <span class="ruby-keyword kw">do</span> <span class="ruby-operator">|</span><span class="ruby-identifier">i</span><span class="ruby-operator">|</span>
-        <span class="ruby-identifier">sep</span> <span class="ruby-operator">&lt;&lt;</span> <span class="ruby-keyword kw">yield</span>(<span class="ruby-identifier">i</span>, <span class="ruby-operator">*</span><span class="ruby-identifier">slice</span>(<span class="ruby-identifier">i</span>,<span class="ruby-value">2</span>))
-      <span class="ruby-keyword kw">end</span>
-    <span class="ruby-keyword kw">else</span>
-      <span class="ruby-identifier">options</span>   = (<span class="ruby-constant">Hash</span><span class="ruby-operator">===</span><span class="ruby-identifier">args</span>.<span class="ruby-identifier">last</span>) <span class="ruby-operator">?</span> <span class="ruby-identifier">args</span>.<span class="ruby-identifier">pop</span> <span class="ruby-operator">:</span> {}
-      <span class="ruby-identifier">separator</span> = <span class="ruby-identifier">args</span>.<span class="ruby-identifier">shift</span> <span class="ruby-operator">||</span> <span class="ruby-value str">&quot;&quot;</span>
-      <span class="ruby-identifier">options</span>[<span class="ruby-value">-1</span>] = <span class="ruby-identifier">args</span>.<span class="ruby-identifier">shift</span> <span class="ruby-keyword kw">unless</span> <span class="ruby-identifier">args</span>.<span class="ruby-identifier">empty?</span>
-      <span class="ruby-identifier">sep</span> = [<span class="ruby-identifier">separator</span>] <span class="ruby-operator">*</span> (<span class="ruby-identifier">size</span> <span class="ruby-operator">-</span> <span class="ruby-value">1</span>)
-      <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">options</span>.<span class="ruby-identifier">key?</span>(<span class="ruby-identifier">:last</span>)
-        <span class="ruby-identifier">options</span>[<span class="ruby-value">-1</span>] = <span class="ruby-identifier">options</span>.<span class="ruby-identifier">delete</span>(<span class="ruby-identifier">:last</span>)
-      <span class="ruby-keyword kw">end</span>
-      <span class="ruby-identifier">options</span>[<span class="ruby-value">-1</span>] <span class="ruby-operator">||=</span> <span class="ruby-value str">&quot; and &quot;</span>
-      <span class="ruby-identifier">options</span>.<span class="ruby-identifier">each</span>{<span class="ruby-operator">|</span><span class="ruby-identifier">i</span>, <span class="ruby-identifier">s</span><span class="ruby-operator">|</span> <span class="ruby-identifier">sep</span>[<span class="ruby-identifier">i</span>] = <span class="ruby-identifier">s</span>}
-    <span class="ruby-keyword kw">end</span>
-    <span class="ruby-identifier">zip</span>(<span class="ruby-identifier">sep</span>).<span class="ruby-identifier">join</span>
-  <span class="ruby-keyword kw">end</span>
-</pre>
-  </div>
-</div>
-</div>
-<div class="method">
-  <div class="title">
-    <a name="M000148"></a><b>delete_unless</b>(&amp;block)
-  </div>
-  <div class="description">
-  <p>
-Inverse of delete_if.
-</p>
-<pre>
-  [1,2,3].delete_unless{ |x| x &lt; 2 }
-  =&gt; [1,2]
-</pre>
-<p>
-CREDIT: Daniel Schierbeck
-</p>
-  </div>
-<div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000148_source')" id="l_M000148_source">+</a> ]</p>
-  <div id="M000148_source" class="dyn-source">
-<pre>
-<span class="ruby-comment cmt"># File lib/core/facets/array/delete_unless.rb, line 10</span>
-  <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">delete_unless</span>(<span class="ruby-operator">&amp;</span><span class="ruby-identifier">block</span>)
-    <span class="ruby-identifier">delete_if</span> { <span class="ruby-operator">|</span><span class="ruby-identifier">element</span><span class="ruby-operator">|</span> <span class="ruby-keyword kw">not</span> <span class="ruby-identifier">block</span>.<span class="ruby-identifier">call</span>(<span class="ruby-identifier">element</span>) }
-  <span class="ruby-keyword kw">end</span>
-</pre>
-  </div>
-</div>
-</div>
-<div class="method">
-  <div class="title">
-    <a name="M000160"></a><b>delete_values</b>(*values)
-  </div>
-  <div class="description">
-  <p>
-Delete multiple values from array.
-</p>
-<pre>
-  a = [1,2,3,4]
-  a.delete_values(1,2)   #=&gt; [1,2]
-  a                      #=&gt; [3,4]
-</pre>
-<p>
-CREDIT: Trans
-</p>
-  </div>
-<div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000160_source')" id="l_M000160_source">+</a> ]</p>
-  <div id="M000160_source" class="dyn-source">
-<pre>
-<span class="ruby-comment cmt"># File lib/core/facets/array/delete_values.rb, line 11</span>
-  <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">delete_values</span>(<span class="ruby-operator">*</span><span class="ruby-identifier">values</span>)
-    <span class="ruby-identifier">d</span> = []
-    <span class="ruby-identifier">values</span>.<span class="ruby-identifier">each</span>{ <span class="ruby-operator">|</span><span class="ruby-identifier">v</span><span class="ruby-operator">|</span> <span class="ruby-identifier">d</span> <span class="ruby-operator">&lt;&lt;</span> <span class="ruby-identifier">delete</span>(<span class="ruby-identifier">v</span>) }
-    <span class="ruby-identifier">d</span>
-  <span class="ruby-keyword kw">end</span>
-</pre>
-  </div>
-</div>
-</div>
-<div class="method">
-  <div class="title">
-    <a name="M000161"></a><b>delete_values_at</b>(*selectors)
-  </div>
-  <div class="description">
-  <p>
-Delete multiple values from array given indexes or <a
-href="Array.html#M000157">index</a> range.
-</p>
-<pre>
-  a = [1,2,3,4]
-  a.delete_values_at(1,2)   #=&gt; [2,3]
-  a                         #=&gt; [1,4]
-  a = [1,2,3,4]
-  a.delete_values_at(0..2)  #=&gt; [1,2,3]
-  a                         #=&gt; [4]
-</pre>
-<p>
-NOTE: It would be nice to see delete_at incorporate this funcitonaility.
-</p>
-<p>
-CREDIT: Trans
-</p>
-  </div>
-<div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000161_source')" id="l_M000161_source">+</a> ]</p>
-  <div id="M000161_source" class="dyn-source">
-<pre>
-<span class="ruby-comment cmt"># File lib/core/facets/array/delete_values.rb, line 32</span>
-  <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">delete_values_at</span>(<span class="ruby-operator">*</span><span class="ruby-identifier">selectors</span>)
-    <span class="ruby-identifier">idx</span> = []
-    <span class="ruby-identifier">selectors</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">case</span> <span class="ruby-identifier">i</span>
-      <span class="ruby-keyword kw">when</span> <span class="ruby-constant">Range</span>
-        <span class="ruby-identifier">idx</span>.<span class="ruby-identifier">concat</span>( <span class="ruby-identifier">i</span>.<span class="ruby-identifier">to_a</span> )
-      <span class="ruby-keyword kw">else</span>
-        <span class="ruby-identifier">idx</span> <span class="ruby-operator">&lt;&lt;</span> <span class="ruby-identifier">i</span>.<span class="ruby-identifier">to_i</span>
-      <span class="ruby-keyword kw">end</span>
-    }
-    <span class="ruby-identifier">idx</span>.<span class="ruby-identifier">uniq!</span>
-    <span class="ruby-identifier">dvals</span> = <span class="ruby-identifier">values_at</span>(<span class="ruby-operator">*</span><span class="ruby-identifier">idx</span>)
-    <span class="ruby-identifier">idx</span> = (<span class="ruby-value">0</span><span class="ruby-operator">...</span><span class="ruby-identifier">size</span>).<span class="ruby-identifier">to_a</span> <span class="ruby-operator">-</span> <span class="ruby-identifier">idx</span>
-    <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">replace</span>( <span class="ruby-identifier">values_at</span>(<span class="ruby-operator">*</span><span class="ruby-identifier">idx</span>) )
-    <span class="ruby-keyword kw">return</span> <span class="ruby-identifier">dvals</span>
-  <span class="ruby-keyword kw">end</span>
-</pre>
-  </div>
-</div>
-</div>
-<div class="method">
-  <div class="title">
-    <a name="M000157"></a><b>index</b>(obj=nil, &amp;block)
-  </div>
-  <div class="description">
-  <p>
-Allows <a href="Array.html#M000157">index</a> to accept a block.
-</p>
-<p>
-OVERRIDE! This is one of the bery few core overrides in Facets.
-</p>
-  </div>
-<div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000157_source')" id="l_M000157_source">+</a> ]</p>
-  <div id="M000157_source" class="dyn-source">
-<pre>
-<span class="ruby-comment cmt"># File lib/core/facets/array/index.rb, line 12</span>
-    <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">index</span>(<span class="ruby-identifier">obj</span>=<span class="ruby-keyword kw">nil</span>, <span class="ruby-operator">&amp;</span><span class="ruby-identifier">block</span>)
-      <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">block_given?</span>
-        <span class="ruby-identifier">_facets_index</span>(<span class="ruby-identifier">find</span>(<span class="ruby-operator">&amp;</span><span class="ruby-identifier">block</span>))
-      <span class="ruby-keyword kw">else</span>
-        <span class="ruby-identifier">_facets_index</span>(<span class="ruby-identifier">obj</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="M000152"></a><b>merge!</b>( other )
-  </div>
-  <div class="description">
-  <p>
-In place merge.
-</p>
-<pre>
-  a = [1,2]
-  a.merge! [2,3]
-  a =&gt; [1,2,3]
-</pre>
-<p>
-CREDIT: Trans
-</p>
-  </div>
-<div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000152_source')" id="l_M000152_source">+</a> ]</p>
-  <div id="M000152_source" class="dyn-source">
-<pre>
-<span class="ruby-comment cmt"># File lib/core/facets/array/merge.rb, line 11</span>
-  <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">merge!</span>( <span class="ruby-identifier">other</span> )
-    <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">replace</span>(<span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">merge</span>(<span class="ruby-identifier">other</span>))
-  <span class="ruby-keyword kw">end</span>
-</pre>
-  </div>
-</div>
-</div>
-<div class="method">
-  <div class="title">
-    <a name="M000147"></a><b>not_empty?</b>()
-  </div>
-  <div class="description">
-  <p>
-Not empty?
-</p>
-<pre>
-  [].not_empty?     #=&gt; false
-  [1,2].not_empty?  #=&gt; true
-</pre>
-  </div>
-<div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000147_source')" id="l_M000147_source">+</a> ]</p>
-  <div id="M000147_source" class="dyn-source">
-<pre>
-<span class="ruby-comment cmt"># File lib/core/facets/array/not_empty.rb, line 8</span>
-  <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">not_empty?</span>
-    <span class="ruby-operator">!</span><span class="ruby-identifier">empty?</span>
-  <span class="ruby-keyword kw">end</span>
-</pre>
-  </div>
-</div>
-</div>
-<div class="method">
-  <div class="title">
-    <a name="M000158"></a><b>only</b>()
-  </div>
-  <div class="description">
-  <p>
-Returns the <em><a href="Array.html#M000158">only</a></em> element in the
-array. Raises an IndexError if the array&#8216;s size is not 1.
-</p>
-<pre>
-  [5].only      # -&gt; 5
-  [1,2,3].only  # -&gt; IndexError
-  [].only       # -&gt; IndexError
-</pre>
-<p>
-CREDIT: Gavin Sinclair, Noah Gibbs
-</p>
-  </div>
-<div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000158_source')" id="l_M000158_source">+</a> ]</p>
-  <div id="M000158_source" class="dyn-source">
-<pre>
-<span class="ruby-comment cmt"># File lib/core/facets/array/only.rb, line 12</span>
-  <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">only</span>
-    <span class="ruby-keyword kw">unless</span> <span class="ruby-identifier">size</span> <span class="ruby-operator">==</span> <span class="ruby-value">1</span>
-      <span class="ruby-identifier">raise</span> <span class="ruby-constant">IndexError</span>, <span class="ruby-value str">&quot;Array#only called on non-single-element array&quot;</span>
-    <span class="ruby-keyword kw">end</span>
-    <span class="ruby-identifier">first</span>
-  <span class="ruby-keyword kw">end</span>
-</pre>
-  </div>
-</div>
-</div>
-<div class="method">
-  <div class="title">
-    <a name="M000163"></a><b>pad</b>(len, val=nil)
-  </div>
-  <div class="description">
-  <p>
-Pad an array with a given <tt>value</tt> upto a given <tt>length</tt>.
-</p>
-<pre>
-  [0,1,2].pad(6,&quot;a&quot;)  #=&gt; [0,1,2,&quot;a&quot;,&quot;a&quot;,&quot;a&quot;]
-</pre>
-<p>
-If <tt>length</tt> is a negative number padding will be added to the
-beginning of the array.
-</p>
-<pre>
-  [0,1,2].pad(-6,&quot;a&quot;)  #=&gt; [&quot;a&quot;,&quot;a&quot;,&quot;a&quot;,0,1,2]
-</pre>
-<p>
-CREDIT: Richard Laugesen
-</p>
-  </div>
-<div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000163_source')" id="l_M000163_source">+</a> ]</p>
-  <div id="M000163_source" class="dyn-source">
-<pre>
-<span class="ruby-comment cmt"># File lib/core/facets/array/pad.rb, line 14</span>
-  <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">pad</span>(<span class="ruby-identifier">len</span>, <span class="ruby-identifier">val</span>=<span class="ruby-keyword kw">nil</span>)
-    <span class="ruby-keyword kw">return</span> <span class="ruby-identifier">dup</span> <span class="ruby-keyword kw">if</span> <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">size</span> <span class="ruby-operator">&gt;=</span> <span class="ruby-identifier">len</span>.<span class="ruby-identifier">abs</span>
-    <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">len</span> <span class="ruby-operator">&lt;</span> <span class="ruby-value">0</span>
-      <span class="ruby-constant">Array</span>.<span class="ruby-identifier">new</span>((<span class="ruby-identifier">len</span><span class="ruby-operator">+</span><span class="ruby-identifier">size</span>).<span class="ruby-identifier">abs</span>,<span class="ruby-identifier">val</span>) <span class="ruby-operator">+</span> <span class="ruby-keyword kw">self</span>
-    <span class="ruby-keyword kw">else</span>
-      <span class="ruby-keyword kw">self</span> <span class="ruby-operator">+</span> <span class="ruby-constant">Array</span>.<span class="ruby-identifier">new</span>(<span class="ruby-identifier">len</span><span class="ruby-operator">-</span><span class="ruby-identifier">size</span>,<span class="ruby-identifier">val</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="M000164"></a><b>pad!</b>(len, val=nil)
-  </div>
-  <div class="description">
-  <p>
-Like <a href="Array.html#M000163">pad</a> but changes the array in place.
-</p>
-<pre>
-   a = [0,1,2]
-   a.pad!(6,&quot;x&quot;)
-   a  #=&gt; [0,1,2,&quot;x&quot;,&quot;x&quot;,&quot;x&quot;]
-</pre>
-<p>
-CREDIT: Richard Laugesen
-</p>
-  </div>
-<div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000164_source')" id="l_M000164_source">+</a> ]</p>
-  <div id="M000164_source" class="dyn-source">
-<pre>
-<span class="ruby-comment cmt"># File lib/core/facets/array/pad.rb, line 31</span>
-  <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">pad!</span>(<span class="ruby-identifier">len</span>, <span class="ruby-identifier">val</span>=<span class="ruby-keyword kw">nil</span>)
-    <span class="ruby-keyword kw">return</span> <span class="ruby-keyword kw">self</span> <span class="ruby-keyword kw">if</span> <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">size</span> <span class="ruby-operator">&gt;=</span> <span class="ruby-identifier">len</span>.<span class="ruby-identifier">abs</span>
-    <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">len</span> <span class="ruby-operator">&lt;</span> <span class="ruby-value">0</span>
-      <span class="ruby-identifier">replace</span> <span class="ruby-constant">Array</span>.<span class="ruby-identifier">new</span>((<span class="ruby-identifier">len</span><span class="ruby-operator">+</span><span class="ruby-identifier">size</span>).<span class="ruby-identifier">abs</span>,<span class="ruby-identifier">val</span>) <span class="ruby-operator">+</span> <span class="ruby-keyword kw">self</span>
-    <span class="ruby-keyword kw">else</span>
-      <span class="ruby-identifier">concat</span> <span class="ruby-constant">Array</span>.<span class="ruby-identifier">new</span>(<span class="ruby-identifier">len</span><span class="ruby-operator">-</span><span class="ruby-identifier">size</span>,<span class="ruby-identifier">val</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="M000155"></a><b>permutation</b>(n=size) {|[]| ...}
-  </div>
-  <div class="description">
-  <p>
-Permutation provids the possible orders of an enumerable. Each is indexed
-by a <a href="Array.html#M000155">permutation</a> number. The maximum
-number of arrangements is the factorial of the size of the array.
-</p>
-<p>
-CREDIT: Shin-ichiro Hara
-</p>
-  </div>
-<div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000155_source')" id="l_M000155_source">+</a> ]</p>
-  <div id="M000155_source" class="dyn-source">
-<pre>
-<span class="ruby-comment cmt"># File lib/core/facets/array/permutation.rb, line 11</span>
-    <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">permutation</span>(<span class="ruby-identifier">n</span>=<span class="ruby-identifier">size</span>)
-      <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">size</span> <span class="ruby-operator">&lt;</span> <span class="ruby-identifier">n</span> <span class="ruby-keyword kw">or</span> <span class="ruby-identifier">n</span> <span class="ruby-operator">&lt;</span> <span class="ruby-value">0</span>
-      <span class="ruby-keyword kw">elsif</span> <span class="ruby-identifier">n</span> <span class="ruby-operator">==</span> <span class="ruby-value">0</span>
-        <span class="ruby-keyword kw">yield</span>([])
-      <span class="ruby-keyword kw">else</span>
-        <span class="ruby-keyword kw">self</span>[<span class="ruby-value">1</span><span class="ruby-operator">..</span><span class="ruby-value">-1</span>].<span class="ruby-identifier">permutation</span>(<span class="ruby-identifier">n</span> <span class="ruby-operator">-</span> <span class="ruby-value">1</span>) <span class="ruby-keyword kw">do</span> <span class="ruby-operator">|</span><span class="ruby-identifier">x</span><span class="ruby-operator">|</span>
-          (<span class="ruby-value">0</span><span class="ruby-operator">...</span><span class="ruby-identifier">n</span>).<span class="ruby-identifier">each</span> <span class="ruby-keyword kw">do</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">x</span>[<span class="ruby-value">0</span><span class="ruby-operator">...</span><span class="ruby-identifier">i</span>] <span class="ruby-operator">+</span> [<span class="ruby-identifier">first</span>] <span class="ruby-operator">+</span> <span class="ruby-identifier">x</span>[<span class="ruby-identifier">i</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">self</span>[<span class="ruby-value">1</span><span class="ruby-operator">..</span><span class="ruby-value">-1</span>].<span class="ruby-identifier">permutation</span>(<span class="ruby-identifier">n</span>) <span class="ruby-keyword kw">do</span> <span class="ruby-operator">|</span><span class="ruby-identifier">x</span><span class="ruby-operator">|</span>
-          <span class="ruby-keyword kw">yield</span>(<span class="ruby-identifier">x</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="M000143"></a><b>product</b>(*enums)
-  </div>
-  <div class="description">
-  <p>
-Provides the cartesian <a href="Array.html#M000143">product</a> of two or
-more arrays.
-</p>
-<pre>
-  a = []
-  [1,2].product([4,5])
-  a  #=&gt; [[1, 4],[1, 5],[2, 4],[2, 5]]
-</pre>
-<p>
-CREDIT: Thomas Hafner
-</p>
-  </div>
-<div class="aka">
-  This method is also aliased as
-  <a href="Array.html#M000144">**</a>
-</div>
-<div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000143_source')" id="l_M000143_source">+</a> ]</p>
-  <div id="M000143_source" class="dyn-source">
-<pre>
-<span class="ruby-comment cmt"># File lib/core/facets/array/product.rb, line 13</span>
-    <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">product</span>(<span class="ruby-operator">*</span><span class="ruby-identifier">enums</span>)
-      <span class="ruby-identifier">enums</span>.<span class="ruby-identifier">unshift</span> <span class="ruby-keyword kw">self</span>
-      <span class="ruby-identifier">result</span> = [[]]
-      <span class="ruby-keyword kw">while</span> [] <span class="ruby-operator">!=</span> <span class="ruby-identifier">enums</span>
-        <span class="ruby-identifier">t</span>, <span class="ruby-identifier">result</span> = <span class="ruby-identifier">result</span>, []
-        <span class="ruby-identifier">b</span>, <span class="ruby-operator">*</span><span class="ruby-identifier">enums</span> = <span class="ruby-identifier">enums</span>
-        <span class="ruby-identifier">t</span>.<span class="ruby-identifier">each</span> <span class="ruby-keyword kw">do</span> <span class="ruby-operator">|</span><span class="ruby-identifier">a</span><span class="ruby-operator">|</span>
-          <span class="ruby-identifier">b</span>.<span class="ruby-identifier">each</span> <span class="ruby-keyword kw">do</span> <span class="ruby-operator">|</span><span class="ruby-identifier">n</span><span class="ruby-operator">|</span>
-            <span class="ruby-identifier">result</span> <span class="ruby-operator">&lt;&lt;</span> <span class="ruby-identifier">a</span> <span class="ruby-operator">+</span> [<span class="ruby-identifier">n</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-identifier">result</span>
-    <span class="ruby-keyword kw">end</span>
-</pre>
-  </div>
-</div>
-</div>
-<div class="method">
-  <div class="title">
-    <a name="M000145"></a><b>recursively</b>() {|a| ...}
-  </div>
-  <div class="description">
-  <p>
-Apply a block to hash, and <a href="Array.html#M000145">recursively</a>
-apply that block to each subhash.
-</p>
-<pre>
-  arr = [&quot;a&quot;, [&quot;b&quot;, &quot;c&quot;, nil], nil]
-  arr.recursively{|a| a.compact! }
-  =&gt; [&quot;a&quot;, [&quot;b&quot;, &quot;c&quot;]]
-</pre>
-<p>
-TODO: Can this be generalized in Enumerbale?
-</p>
-  </div>
-<div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000145_source')" id="l_M000145_source">+</a> ]</p>
-  <div id="M000145_source" class="dyn-source">
-<pre>
-<span class="ruby-comment cmt"># File lib/core/facets/array/recursively.rb, line 12</span>
-  <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">recursively</span>(<span class="ruby-operator">&amp;</span><span class="ruby-identifier">block</span>)
-    <span class="ruby-identifier">a</span> = <span class="ruby-identifier">inject</span>([]) <span class="ruby-keyword kw">do</span> <span class="ruby-operator">|</span><span class="ruby-identifier">array</span>, <span class="ruby-identifier">value</span><span class="ruby-operator">|</span>
-      <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">value</span>.<span class="ruby-identifier">is_a?</span>(<span class="ruby-constant">Array</span>)
-        <span class="ruby-identifier">array</span> <span class="ruby-operator">&lt;&lt;</span> <span class="ruby-identifier">value</span>.<span class="ruby-identifier">recursively</span>(<span class="ruby-operator">&amp;</span><span class="ruby-identifier">block</span>)
-      <span class="ruby-keyword kw">else</span>
-        <span class="ruby-identifier">array</span> <span class="ruby-operator">&lt;&lt;</span> <span class="ruby-identifier">value</span>
-      <span class="ruby-keyword kw">end</span>
-      <span class="ruby-identifier">array</span>
-    <span class="ruby-keyword kw">end</span>
-    <span class="ruby-keyword kw">yield</span> <span class="ruby-identifier">a</span>
-  <span class="ruby-keyword kw">end</span>
-</pre>
-  </div>
-</div>
-</div>
-<div class="method">
-  <div class="title">
-    <a name="M000146"></a><b>recursively!</b>(&amp;block)
-  </div>
-  <div class="description">
-  <p>
-In place form of <a href="Array.html#M000145">recursively</a>.
-</p>
-  </div>
-<div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000146_source')" id="l_M000146_source">+</a> ]</p>
-  <div id="M000146_source" class="dyn-source">
-<pre>
-<span class="ruby-comment cmt"># File lib/core/facets/array/recursively.rb, line 26</span>
-  <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">recursively!</span>(<span class="ruby-operator">&amp;</span><span class="ruby-identifier">block</span>)
-    <span class="ruby-identifier">replace</span>(<span class="ruby-identifier">recursively</span>(<span class="ruby-operator">&amp;</span><span class="ruby-identifier">block</span>))
-  <span class="ruby-keyword kw">end</span>
-</pre>
-  </div>
-</div>
-</div>
-<div class="method">
-  <div class="title">
-    <a name="M000149"></a><b>rotate</b>(n=1)
-  </div>
-  <div class="description">
-  <p>
-Rotates an array&#8216;s elements from back to front n times.
-</p>
-<pre>
-  [1,2,3].rotate      #=&gt; [3,1,2]
-  [3,1,2].rotate      #=&gt; [2,3,1]
-  [3,1,2].rotate      #=&gt; [1,2,3]
-  [1,2,3].rotate(3)   #=&gt; [1,2,3]
-</pre>
-<p>
-A negative parameter reverses the order from front to back.
-</p>
-<pre>
-  [1,2,3].rotate(-1)  #=&gt; [2,3,1]
-</pre>
-<p>
-CREDIT: Florian Gross, Thomas Sawyer
-</p>
-  </div>
-<div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000149_source')" id="l_M000149_source">+</a> ]</p>
-  <div id="M000149_source" class="dyn-source">
-<pre>
-<span class="ruby-comment cmt"># File lib/core/facets/array/rotate.rb, line 16</span>
-  <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">rotate</span>(<span class="ruby-identifier">n</span>=<span class="ruby-value">1</span>)
-    <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">dup</span>.<span class="ruby-identifier">rotate!</span>(<span class="ruby-identifier">n</span>)
-  <span class="ruby-keyword kw">end</span>
-</pre>
-  </div>
-</div>
-</div>
-<div class="method">
-  <div class="title">
-    <a name="M000150"></a><b>rotate!</b>(n=1)
-  </div>
-  <div class="description">
-  <p>
-Same as <a href="Array.html#M000149">rotate</a>, but acts in place.
-</p>
-<pre>
-  a = [1,2,3]
-  a.rotate!
-  a  #=&gt; [3,1,2]
-</pre>
-<p>
-CREDIT: Florian Gross, Thomas Sawyer
-</p>
-  </div>
-<div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000150_source')" id="l_M000150_source">+</a> ]</p>
-  <div id="M000150_source" class="dyn-source">
-<pre>
-<span class="ruby-comment cmt"># File lib/core/facets/array/rotate.rb, line 28</span>
-  <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">rotate!</span>(<span class="ruby-identifier">n</span>=<span class="ruby-value">1</span>)
-    <span class="ruby-identifier">n</span> = <span class="ruby-identifier">n</span>.<span class="ruby-identifier">to_int</span>
-    <span class="ruby-keyword kw">return</span> <span class="ruby-keyword kw">self</span> <span class="ruby-keyword kw">if</span> (<span class="ruby-identifier">n</span> <span class="ruby-operator">==</span> <span class="ruby-value">0</span> <span class="ruby-keyword kw">or</span> <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">empty?</span>)
-    <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">n</span> <span class="ruby-operator">&gt;</span> <span class="ruby-value">0</span>
-      <span class="ruby-identifier">n</span>.<span class="ruby-identifier">abs</span>.<span class="ruby-identifier">times</span>{ <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">unshift</span>( <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">pop</span> ) }
-    <span class="ruby-keyword kw">else</span>
-      <span class="ruby-identifier">n</span>.<span class="ruby-identifier">abs</span>.<span class="ruby-identifier">times</span>{ <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">push</span>( <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">shift</span> ) }
-    <span class="ruby-keyword kw">end</span>
-    <span class="ruby-keyword kw">self</span>
-  <span class="ruby-keyword kw">end</span>
-</pre>
-  </div>
-</div>
-</div>
-<div class="method">
-  <div class="title">
-    <a name="M000156"></a><b>select!</b>( {|| ...}
-  </div>
-  <div class="description">
-  <p>
-As with select but modifies the <a href="Array.html">Array</a> in place.
-</p>
-<pre>
-  a = [1,2,3,4,5,6,7,8,9,10]
-  a.select!{ |e| e % 2 == 0 }
-  a  #=&gt; [2,4,6,8,10]
-</pre>
-<p>
-CREDIT: Gavin Sinclair
-</p>
-  </div>
-<div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000156_source')" id="l_M000156_source">+</a> ]</p>
-  <div id="M000156_source" class="dyn-source">
-<pre>
-<span class="ruby-comment cmt"># File lib/core/facets/array/select.rb, line 11</span>
-  <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">select!</span>  <span class="ruby-comment cmt"># :yield:</span>
-    <span class="ruby-identifier">reject!</span>{ <span class="ruby-operator">|</span><span class="ruby-identifier">e</span><span class="ruby-operator">|</span> <span class="ruby-keyword kw">not</span> <span class="ruby-keyword kw">yield</span>(<span class="ruby-identifier">e</span>) }
-  <span class="ruby-keyword kw">end</span>
-</pre>
-  </div>
-</div>
-</div>
-<div class="method">
-  <div class="title">
-    <a name="M000162"></a><b>splice</b>(*args)
-  </div>
-  <div class="description">
-  <p>
-Splice acts a <a href="Array.html#M000159">combination</a> of slice! and
-store. If two arguments are given it calls store. If a single argument is
-give it calls slice!.
-</p>
-<pre>
-  a = [1,2,3]
-  a.splice(1)    #=&gt; 2
-  a              #=&gt; [1,3]
-  a = [1,2,3]
-  a.splice(1,4)  #=&gt; 4
-  a              #=&gt;[1,4,3]
-</pre>
-<p>
-CREDIT: Trans
-</p>
-  </div>
-<div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000162_source')" id="l_M000162_source">+</a> ]</p>
-  <div id="M000162_source" class="dyn-source">
-<pre>
-<span class="ruby-comment cmt"># File lib/core/facets/array/splice.rb, line 17</span>
-  <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">splice</span>(<span class="ruby-operator">*</span><span class="ruby-identifier">args</span>)
-    <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">args</span>.<span class="ruby-identifier">size</span> <span class="ruby-operator">==</span> <span class="ruby-value">1</span>
-      <span class="ruby-identifier">slice!</span>(<span class="ruby-operator">*</span><span class="ruby-identifier">args</span>)
-    <span class="ruby-keyword kw">else</span>
-      <span class="ruby-identifier">store</span>(<span class="ruby-operator">*</span><span class="ruby-identifier">args</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="M000142"></a><b>to_b</b>()
-  </div>
-  <div class="description">
-  <p>
-Boolean conversion for not empty?
-</p>
-  </div>
-<div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000142_source')" id="l_M000142_source">+</a> ]</p>
-  <div id="M000142_source" class="dyn-source">
-<pre>
-<span class="ruby-comment cmt"># File lib/core/facets/boolean.rb, line 60</span>
-  <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">to_b</span>
-    <span class="ruby-operator">!</span> <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">empty?</span>
-  <span class="ruby-keyword kw">end</span>
-</pre>
-  </div>
-</div>
-</div>
-<div class="method">
-  <div class="title">
-    <a name="M000136"></a><b>to_h</b>(mode=nil)
-  </div>
-  <div class="description">
-  <p>
-Converts an array into a hash. Converting an array into a hash is not a
-one-to-one conversion, for this reason <a
-href="Array.html#M000136">to_h</a> examines at the array being converted
-and then dispatches the conversion to the most sutiable specialized
-function. There are three possiblities for this.
-</p>
-<p>
-If the array is a collection of perfect pairs, like that which Hash#to_a
-generates, then conversion is handled by <a
-href="Array.html#M000139">to_h_flat</a>.
-</p>
-<pre>
-  a = [ [:a,1], [:b,2] ]
-  a.to_h  #=&gt; { :a=&gt;1, :b=&gt;2 }
-</pre>
-<p>
-If the array contains <a href="Array.html#M000158">only</a> arrays, but are
-not perfect pairs, then <a href="Array.html#M000141">to_h_multi</a> is
-called.
-</p>
-<pre>
-  a = [ [:a,1,2], [:b,2], [:c], [:d] ]
-  a.to_h  #=&gt; { :a=&gt;[1,2], :b=&gt;[2], :c=&gt;[], :d=&gt;[] }
-</pre>
-<p>
-If the array contians objects other then arrays then the <a
-href="Array.html#M000138">to_h_splat</a> method is called.
-</p>
-<pre>
-  a = [ [:a,1,2], 2, :b, [:c,3], 9 ]
-  a.to_h  #=&gt; { [:a,1,2]=&gt;2, :b=&gt;[:c,3], 9=&gt;nil }
-</pre>
-<p>
-Finally, a particular dispatch can be forced by specifying the
-<tt>mode</tt> of conversion, eg. +:multi+, +:splat+, +:flat+, +:assoc+,
-etc.
-</p>
-<p>
-Setting <tt>mode</tt> to <tt>true</tt> is the same as setting it +:multi+.
-This has been left in for backward compatability.
-</p>
-<p>
-NOTE: The use of a <tt>values</tt> parameter has been deprecated because
-that functionality is as simple as:
-</p>
-<pre>
-  array1.zip(array2).to_h
-</pre>
-<p>
-CREDIT: Robert Klemme CREDIT: Trans
-</p>
-  </div>
-<div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000136_source')" id="l_M000136_source">+</a> ]</p>
-  <div id="M000136_source" class="dyn-source">
-<pre>
-<span class="ruby-comment cmt"># File lib/core/facets/to_hash.rb, line 53</span>
-  <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">to_h</span>(<span class="ruby-identifier">mode</span>=<span class="ruby-keyword kw">nil</span>)
-    <span class="ruby-keyword kw">case</span> <span class="ruby-identifier">mode</span>
-    <span class="ruby-keyword kw">when</span> <span class="ruby-identifier">:splat</span>
-      <span class="ruby-keyword kw">return</span> <span class="ruby-identifier">to_h_splat</span>
-    <span class="ruby-keyword kw">when</span> <span class="ruby-identifier">:flat</span>
-      <span class="ruby-keyword kw">return</span> <span class="ruby-identifier">to_h_flat</span>
-    <span class="ruby-keyword kw">when</span> <span class="ruby-identifier">:multi</span>, <span class="ruby-keyword kw">true</span>
-      <span class="ruby-keyword kw">return</span> <span class="ruby-identifier">to_h_multi</span>
-    <span class="ruby-keyword kw">when</span> <span class="ruby-identifier">:assoc</span>
-      <span class="ruby-keyword kw">return</span> <span class="ruby-identifier">to_h_assoc</span>
-    <span class="ruby-keyword kw">else</span>
-      <span class="ruby-keyword kw">return</span> <span class="ruby-identifier">to_h_auto</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="M000140"></a><b>to_h_assoc</b>()
-  </div>
-  <div class="description">
-  <p>
-When a mixed or multi-element accociative array is used, the result is as
-follows:
-</p>
-<pre>
-  a = [ [:a,1,2], [:b,2], [:c], :d ]
-  a.to_h  #=&gt; { :a=&gt;[1,2], :b=&gt;[2], :c=&gt;[], :d=&gt;[] }
-</pre>
-<p>
-If the first entry of any subelements are the same, then the value will be
-set to the last occuring value.
-</p>
-<pre>
-  a = [ :x, [:x], [:x,1,2], [:x,3], [:x,4] ]
-  a.to_h_assoc  #=&gt; { :x=&gt;4 }
-</pre>
-  </div>
-<div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000140_source')" id="l_M000140_source">+</a> ]</p>
-  <div id="M000140_source" class="dyn-source">
-<pre>
-<span class="ruby-comment cmt"># File lib/core/facets/to_hash.rb, line 157</span>
-  <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">to_h_assoc</span>
-    <span class="ruby-identifier">h</span> = {}
-    <span class="ruby-identifier">each</span> <span class="ruby-keyword kw">do</span> <span class="ruby-operator">|</span><span class="ruby-identifier">k</span>,<span class="ruby-operator">*</span><span class="ruby-identifier">v</span><span class="ruby-operator">|</span>
-      <span class="ruby-identifier">h</span>[<span class="ruby-identifier">k</span>] = <span class="ruby-identifier">v</span>
-    <span class="ruby-keyword kw">end</span>
-    <span class="ruby-identifier">h</span>
-  <span class="ruby-keyword kw">end</span>
-</pre>
-  </div>
-</div>
-</div>
-<div class="method">
-  <div class="title">
-    <a name="M000137"></a><b>to_h_auto</b>()
-  </div>
-  <div class="description">
-  <p>
-Converts an array into a hash. Converting an array into a hash is not a
-one-to-one conversion, for this reason <a
-href="Array.html#M000136">to_h</a> examines at the array being converted
-and then dispatches the conversion to the most sutiable specialized
-function. There are three possiblities for this.
-</p>
-<p>
-If the array is a collection of perfect pairs, like that which Hash#to_a
-generates, then conversion is handled by <a
-href="Array.html#M000139">to_h_flat</a>.
-</p>
-<pre>
-  a = [ [:a,1], [:b,2] ]
-  a.to_h  #=&gt; { :a=&gt;1, :b=&gt;2 }
-</pre>
-<p>
-If the array contains <a href="Array.html#M000158">only</a> arrays, but are
-not perfect pairs, then <a href="Array.html#M000141">to_h_multi</a> is
-called.
-</p>
-<pre>
-  a = [ [:a,1,2], [:b,2], [:c], [:d] ]
-  a.to_h  #=&gt; { :a=&gt;[1,2], :b=&gt;[2], :c=&gt;[], :d=&gt;[] }
-</pre>
-<p>
-If the array contians objects other then arrays then the <a
-href="Array.html#M000138">to_h_splat</a> method is called.
-</p>
-<pre>
-  a = [ [:a,1,2], 2, :b, [:c,3], 9 ]
-  a.to_h  #=&gt; { [:a,1,2]=&gt;2, :b=&gt;[:c,3], 9=&gt;nil }
-</pre>
-  </div>
-<div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000137_source')" id="l_M000137_source">+</a> ]</p>
-  <div id="M000137_source" class="dyn-source">
-<pre>
-<span class="ruby-comment cmt"># File lib/core/facets/to_hash.rb, line 93</span>
-  <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">to_h_auto</span>
-    <span class="ruby-identifier">pairs</span> = <span class="ruby-keyword kw">true</span>
-    <span class="ruby-identifier">mixed</span> = <span class="ruby-keyword kw">false</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">case</span> <span class="ruby-identifier">e</span>
-      <span class="ruby-keyword kw">when</span> <span class="ruby-constant">Array</span>
-        <span class="ruby-identifier">pairs</span> = <span class="ruby-keyword kw">false</span> <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">e</span>.<span class="ruby-identifier">size</span> <span class="ruby-operator">&gt;</span> <span class="ruby-value">2</span>
-      <span class="ruby-keyword kw">else</span>
-        <span class="ruby-identifier">mixed</span> = <span class="ruby-keyword kw">true</span>
-      <span class="ruby-keyword kw">end</span>
-    <span class="ruby-keyword kw">end</span>
-    <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">mixed</span>
-      <span class="ruby-identifier">to_h_splat</span>
-    <span class="ruby-keyword kw">elsif</span> <span class="ruby-identifier">pairs</span>
-      <span class="ruby-identifier">to_h_flat</span>
-    <span class="ruby-keyword kw">else</span>
-      <span class="ruby-identifier">to_h_multi</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="M000139"></a><b>to_h_flat</b>()
-  </div>
-  <div class="description">
-  <p>
-This is equivalent to <a href="http://*array.flatten">Hash</a>, but it will
-<a href="Array.html#M000163">pad</a> the array with a <tt>nil</tt> object
-if there are not an even number of elements.
-</p>
-<pre>
-  a = [:a,1,[:b,2,:c]]
-  a.to_h_flat  #=&gt; { :a=&gt;1, :b=&gt;2, :c=&gt;nil }
-</pre>
-  </div>
-<div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000139_source')" id="l_M000139_source">+</a> ]</p>
-  <div id="M000139_source" class="dyn-source">
-<pre>
-<span class="ruby-comment cmt"># File lib/core/facets/to_hash.rb, line 135</span>
-  <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">to_h_flat</span>
-    <span class="ruby-identifier">a</span> = <span class="ruby-identifier">flatten</span>
-    <span class="ruby-identifier">a</span> <span class="ruby-operator">&lt;&lt;</span> <span class="ruby-keyword kw">nil</span> <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">a</span>.<span class="ruby-identifier">size</span> <span class="ruby-operator">%</span> <span class="ruby-value">2</span> <span class="ruby-operator">==</span> <span class="ruby-value">1</span>
-    <span class="ruby-constant">Hash</span>[<span class="ruby-operator">*</span><span class="ruby-identifier">a</span>]
-  <span class="ruby-keyword kw">end</span>
-</pre>
-  </div>
-</div>
-</div>
-<div class="method">
-  <div class="title">
-    <a name="M000141"></a><b>to_h_multi</b>()
-  </div>
-  <div class="description">
-  <p>
-When a mixed or multi-element accociative array is used, the result is as
-follows:
-</p>
-<pre>
-  a = [ [:a,1,2], [:b,2], [:c], :d ]
-  a.to_h  #=&gt; { :a=&gt;[1,2], :b=&gt;[2], :c=&gt;[], :d=&gt;[] }
-</pre>
-<p>
-If the first entry of the subelements is the same, then the values will be
-merged using concat.
-</p>
-<pre>
-  a = [ [:a,1,2], [:a,3], [:a,4], [:a], :a ]
-  a.to_h_multi  #=&gt; { :a=&gt;[1,2,3,4] }
-</pre>
-  </div>
-<div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000141_source')" id="l_M000141_source">+</a> ]</p>
-  <div id="M000141_source" class="dyn-source">
-<pre>
-<span class="ruby-comment cmt"># File lib/core/facets/to_hash.rb, line 177</span>
-  <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">to_h_multi</span>
-    <span class="ruby-identifier">h</span> = {}
-    <span class="ruby-identifier">each</span> <span class="ruby-keyword kw">do</span> <span class="ruby-operator">|</span><span class="ruby-identifier">k</span>,<span class="ruby-operator">*</span><span class="ruby-identifier">v</span><span class="ruby-operator">|</span>
-      <span class="ruby-identifier">h</span>[<span class="ruby-identifier">k</span>] <span class="ruby-operator">||=</span> []
-      <span class="ruby-identifier">h</span>[<span class="ruby-identifier">k</span>].<span class="ruby-identifier">concat</span>(<span class="ruby-identifier">v</span>)
-    <span class="ruby-keyword kw">end</span>
-    <span class="ruby-identifier">h</span>
-  <span class="ruby-keyword kw">end</span>
-</pre>
-  </div>
-</div>
-</div>
-<div class="method">
-  <div class="title">
-    <a name="M000138"></a><b>to_h_splat</b>()
-  </div>
-  <div class="description">
-  <p>
-This is equivalent to <a href="Hash.html">Hash</a>[*array], but it will <a
-href="Array.html#M000163">pad</a> the array with a <tt>nil</tt> object if
-there are not an even number of elements.
-</p>
-<pre>
-  a = [:a,1,:b,2,:c]
-  a.to_h_splat  #=&gt; { :a=&gt;1, :b=&gt;2, :c=&gt;nil }
-</pre>
-  </div>
-<div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000138_source')" id="l_M000138_source">+</a> ]</p>
-  <div id="M000138_source" class="dyn-source">
-<pre>
-<span class="ruby-comment cmt"># File lib/core/facets/to_hash.rb, line 122</span>
-  <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">to_h_splat</span>
-    <span class="ruby-identifier">a</span> = <span class="ruby-identifier">dup</span>
-    <span class="ruby-identifier">a</span> <span class="ruby-operator">&lt;&lt;</span> <span class="ruby-keyword kw">nil</span> <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">a</span>.<span class="ruby-identifier">size</span> <span class="ruby-operator">%</span> <span class="ruby-value">2</span> <span class="ruby-operator">==</span> <span class="ruby-value">1</span>
-    <span class="ruby-constant">Hash</span>[<span class="ruby-operator">*</span><span class="ruby-identifier">a</span>]
-  <span class="ruby-keyword kw">end</span>
-</pre>
-  </div>
-</div>
-</div>
-<div class="method">
-  <div class="title">
-    <a name="M000153"></a><b>traverse</b>() {|item| ...}
-  </div>
-<div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000153_source')" id="l_M000153_source">+</a> ]</p>
-  <div id="M000153_source" class="dyn-source">
-<pre>
-<span class="ruby-comment cmt"># File lib/core/facets/array/traverse.rb, line 5</span>
-  <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">traverse</span>(<span class="ruby-operator">&amp;</span><span class="ruby-identifier">block</span>)
-    <span class="ruby-identifier">map</span> <span class="ruby-keyword kw">do</span> <span class="ruby-operator">|</span><span class="ruby-identifier">item</span><span class="ruby-operator">|</span>
-      <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">item</span>.<span class="ruby-identifier">is_a?</span>(<span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">class</span>)
-        <span class="ruby-identifier">item</span>.<span class="ruby-identifier">traverse</span>(<span class="ruby-operator">&amp;</span><span class="ruby-identifier">block</span>)
-      <span class="ruby-keyword kw">else</span>
-        <span class="ruby-keyword kw">yield</span> <span class="ruby-identifier">item</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="M000154"></a><b>traverse!</b>(&amp;block)
-  </div>
-<div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000154_source')" id="l_M000154_source">+</a> ]</p>
-  <div id="M000154_source" class="dyn-source">
-<pre>
-<span class="ruby-comment cmt"># File lib/core/facets/array/traverse.rb, line 17</span>
-  <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">traverse!</span>(<span class="ruby-operator">&amp;</span><span class="ruby-identifier">block</span>)
-    <span class="ruby-identifier">replace</span>(<span class="ruby-identifier">traverse</span>(<span class="ruby-operator">&amp;</span><span class="ruby-identifier">block</span>))
-  <span class="ruby-keyword kw">end</span>
-</pre>
-  </div>
-</div>
-</div>
-</div>
-  </div>
-    </body>
-</html>