RubyGems - facets - Versions diffs - 1.4.3 → 1.4.4 - Mend

facets 1.4.3 → 1.4.4

Files changed (1229) hide show

data/doc/api/core/classes/Float.html ADDED

@@ -0,0 +1,157 @@
+<?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: Float</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 = "show source"
+          }
+          else
+          {
+            elem.style.display = "block"
+            link.innerHTML = "hide source"
+          }
+        }
+        function openCode( url )
+        {
+          window.open( url, "SOURCE_CODE", "width=400,height=400,scrollbars=yes" )
+        }
+      // ]]>
+    </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 />Float</td>
+  <td align="right">
+    <table cellspacing=0 cellpadding=2>
+      <tr valign="top">
+        <td>In:</td>
+        <td>
+<a href="../files/lib/facets/core/float/round_at_rb.html">lib/facets/core/float/round_at.rb</a>
+<a href="../files/lib/facets/core/float/round_to_rb.html">lib/facets/core/float/round_to.rb</a>
+<a href="../files/lib/facets/core/float/round_off_rb.html">lib/facets/core/float/round_off.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>
+  <ul>
+  <li><a href="#M000204">round_at</a></li>
+  <li><a href="#M000205">round_to</a></li>
+  </ul>
+<div class="sectiontitle">Public Instance methods</div>
+<div class="method">
+  <div class="title">
+    <a name="M000204"></a><b>round_at</b>( d )
+  </div>
+  <div class="description">
+  <p>
+Rounds to the given decimal position.
+</p>
+<pre>
+  4.555.round_at(0)  #=&gt; 5.0
+  4.555.round_at(1)  #=&gt; 4.6
+  4.555.round_at(2)  #=&gt; 4.56
+  4.555.round_at(3)  #=&gt; 4.555
+</pre>
+  </div>
+<div class="sourcecode">
+  <p class="source-link">[ <a href="javascript:toggleSource('M000204_source')" id="l_M000204_source">show source</a> ]</p>
+  <div id="M000204_source" class="dyn-source">
+<pre>
+<span class="ruby-comment cmt"># File lib/facets/core/float/round_at.rb, line 13</span>
+  <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">round_at</span>( <span class="ruby-identifier">d</span> ) <span class="ruby-comment cmt">#d=0</span>
+    (<span class="ruby-keyword kw">self</span> <span class="ruby-operator">*</span> (<span class="ruby-value">10.0</span> <span class="ruby-operator">**</span> <span class="ruby-identifier">d</span>)).<span class="ruby-identifier">round_off</span>.<span class="ruby-identifier">to_f</span> <span class="ruby-operator">/</span> (<span class="ruby-value">10.0</span> <span class="ruby-operator">**</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="M000205"></a><b>round_to</b>( n )
+  </div>
+  <div class="description">
+  <p>
+Rounds to the nearest _n_th degree.
+</p>
+<pre>
+  4.555.round_to(1)     #=&gt; 5.0
+  4.555.round_to(0.1)   #=&gt; 4.6
+  4.555.round_to(0.01)  #=&gt; 4.56
+  4.555.round_to(0)     #=&gt; 4.555
+</pre>
+  </div>
+<div class="sourcecode">
+  <p class="source-link">[ <a href="javascript:toggleSource('M000205_source')" id="l_M000205_source">show source</a> ]</p>
+  <div id="M000205_source" class="dyn-source">
+<pre>
+<span class="ruby-comment cmt"># File lib/facets/core/float/round_to.rb, line 13</span>
+  <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">round_to</span>( <span class="ruby-identifier">n</span> ) <span class="ruby-comment cmt">#n=1</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">self</span> <span class="ruby-operator">*</span> (<span class="ruby-value">1.0</span> <span class="ruby-operator">/</span> <span class="ruby-identifier">n</span>)).<span class="ruby-identifier">round_off</span>.<span class="ruby-identifier">to_f</span> <span class="ruby-operator">/</span> (<span class="ruby-value">1.0</span> <span class="ruby-operator">/</span> <span class="ruby-identifier">n</span>)
+  <span class="ruby-keyword kw">end</span>
+</pre>
+  </div>
+</div>
+</div>
+</div>
+  </div>
+    </body>
+</html>

data/doc/api/core/classes/Gem.html ADDED

@@ -0,0 +1,150 @@
+<?xml version="1.0" encoding="iso-8859-1"?>
+<!DOCTYPE html
+     PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
+     "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+<html>
+  <head>
+    <title>Module: Gem</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 = "show source"
+          }
+          else
+          {
+            elem.style.display = "block"
+            link.innerHTML = "hide source"
+          }
+        }
+        function openCode( url )
+        {
+          window.open( url, "SOURCE_CODE", "width=400,height=400,scrollbars=yes" )
+        }
+      // ]]>
+    </script>
+  </head>
+  <body>
+  <table width="100%" border='0' cellpadding='0' cellspacing='0' class='banner'><tr>
+  <td class="file-title"><span class="file-title-prefix">Module</span><br />Gem</td>
+  <td align="right">
+    <table cellspacing=0 cellpadding=2>
+      <tr valign="top">
+        <td>In:</td>
+        <td>
+<a href="../files/lib/facets/core/gem/self/active_rb.html">lib/facets/core/gem/self/active.rb</a>
+<a href="../files/lib/facets/core/gem/self/gemspec_rb.html">lib/facets/core/gem/self/gemspec.rb</a>
+<a href="../files/lib/facets/core/gem/self/gempath_rb.html">lib/facets/core/gem/self/gempath.rb</a>
+        </td>
+      </tr>
+         </table>
+        </td>
+        </tr>
+      </table>
+ <!-- banner header -->
+  <div id="bodyContent">
+      <div id="content">
+  <div class="sectiontitle">Methods</div>
+  <ul>
+  <li><a href="#M000399">active?</a></li>
+  <li><a href="#M000401">gempath</a></li>
+  <li><a href="#M000400">gemspec</a></li>
+  </ul>
+<div class="sectiontitle">Public Class methods</div>
+<div class="method">
+  <div class="title">
+    <a name="M000399"></a><b>active?</b>(gemname)
+  </div>
+<div class="sourcecode">
+  <p class="source-link">[ <a href="javascript:toggleSource('M000399_source')" id="l_M000399_source">show source</a> ]</p>
+  <div id="M000399_source" class="dyn-source">
+<pre>
+<span class="ruby-comment cmt"># File lib/facets/core/gem/self/active.rb, line 4</span>
+  <span class="ruby-keyword kw">def</span> <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">active?</span>(<span class="ruby-identifier">gemname</span>)
+    <span class="ruby-ivar">@loaded_specs</span> <span class="ruby-operator">||=</span> <span class="ruby-constant">Hash</span>.<span class="ruby-identifier">new</span>
+    <span class="ruby-ivar">@loaded_specs</span>.<span class="ruby-identifier">key?</span> <span class="ruby-identifier">gemname</span>
+  <span class="ruby-keyword kw">end</span>
+</pre>
+  </div>
+</div>
+</div>
+<div class="method">
+  <div class="title">
+    <a name="M000401"></a><b>gempath</b>(gemname, subdir=nil)
+  </div>
+<div class="sourcecode">
+  <p class="source-link">[ <a href="javascript:toggleSource('M000401_source')" id="l_M000401_source">show source</a> ]</p>
+  <div id="M000401_source" class="dyn-source">
+<pre>
+<span class="ruby-comment cmt"># File lib/facets/core/gem/self/gempath.rb, line 6</span>
+  <span class="ruby-keyword kw">def</span> <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">gempath</span>(<span class="ruby-identifier">gemname</span>, <span class="ruby-identifier">subdir</span>=<span class="ruby-keyword kw">nil</span>)
+    <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">active?</span>(<span class="ruby-identifier">gemname</span>)
+      <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">subdir</span>
+        <span class="ruby-constant">File</span>.<span class="ruby-identifier">join</span>( <span class="ruby-ivar">@loaded_specs</span>[<span class="ruby-identifier">gemname</span>].<span class="ruby-identifier">full_gem_path</span>, <span class="ruby-identifier">subdir</span> )
+      <span class="ruby-keyword kw">else</span>
+        <span class="ruby-ivar">@loaded_specs</span>[<span class="ruby-identifier">gemname</span>].<span class="ruby-identifier">full_gem_path</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="M000400"></a><b>gemspec</b>(gemname)
+  </div>
+<div class="sourcecode">
+  <p class="source-link">[ <a href="javascript:toggleSource('M000400_source')" id="l_M000400_source">show source</a> ]</p>
+  <div id="M000400_source" class="dyn-source">
+<pre>
+<span class="ruby-comment cmt"># File lib/facets/core/gem/self/gemspec.rb, line 6</span>
+  <span class="ruby-keyword kw">def</span> <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">gemspec</span>(<span class="ruby-identifier">gemname</span>)
+    <span class="ruby-ivar">@loaded_specs</span>[<span class="ruby-identifier">gemname</span>] <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">active?</span>(<span class="ruby-identifier">gemname</span>)
+  <span class="ruby-keyword kw">end</span>
+</pre>
+  </div>
+</div>
+</div>
+</div>
+  </div>
+    </body>
+</html>

data/doc/api/core/classes/Hash.html ADDED

@@ -0,0 +1,1627 @@
+<?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: Hash</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 = "show source"
+          }
+          else
+          {
+            elem.style.display = "block"
+            link.innerHTML = "hide source"
+          }
+        }
+        function openCode( url )
+        {
+          window.open( url, "SOURCE_CODE", "width=400,height=400,scrollbars=yes" )
+        }
+      // ]]>
+    </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 />Hash</td>
+  <td align="right">
+    <table cellspacing=0 cellpadding=2>
+      <tr valign="top">
+        <td>In:</td>
+        <td>
+<a href="../files/lib/facets/core/hash/collate_rb.html">lib/facets/core/hash/collate.rb</a>
+<a href="../files/lib/facets/core/hash/assert_has_keys_rb.html">lib/facets/core/hash/assert_has_keys.rb</a>
+<a href="../files/lib/facets/core/hash/each_with_key_rb.html">lib/facets/core/hash/each_with_key.rb</a>
+<a href="../files/lib/facets/core/hash/join_rb.html">lib/facets/core/hash/join.rb</a>
+<a href="../files/lib/facets/core/hash/at_rb.html">lib/facets/core/hash/at.rb</a>
+<a href="../files/lib/facets/core/hash/each_rb.html">lib/facets/core/hash/each.rb</a>
+<a href="../files/lib/facets/core/hash/each_with_index_rb.html">lib/facets/core/hash/each_with_index.rb</a>
+<a href="../files/lib/facets/core/hash/graph_rb.html">lib/facets/core/hash/graph.rb</a>
+<a href="../files/lib/facets/core/hash/to_ostruct_rb.html">lib/facets/core/hash/to_ostruct.rb</a>
+<a href="../files/lib/facets/core/hash/update_values_rb.html">lib/facets/core/hash/update_values.rb</a>
+<a href="../files/lib/facets/core/hash/inverse_rb.html">lib/facets/core/hash/inverse.rb</a>
+<a href="../files/lib/facets/core/hash/rand_value_rb.html">lib/facets/core/hash/rand_value.rb</a>
+<a href="../files/lib/facets/core/hash/assert_has_only_keys_rb.html">lib/facets/core/hash/assert_has_only_keys.rb</a>
+<a href="../files/lib/facets/core/hash/keys_to_sym_rb.html">lib/facets/core/hash/keys_to_sym.rb</a>
+<a href="../files/lib/facets/core/hash/delete_unless_rb.html">lib/facets/core/hash/delete_unless.rb</a>
+<a href="../files/lib/facets/core/hash/has_only_keys_rb.html">lib/facets/core/hash/has_only_keys.rb</a>
+<a href="../files/lib/facets/core/hash/replace_each_rb.html">lib/facets/core/hash/replace_each.rb</a>
+<a href="../files/lib/facets/core/hash/swap_rb.html">lib/facets/core/hash/swap.rb</a>
+<a href="../files/lib/facets/core/hash/rand_key_rb.html">lib/facets/core/hash/rand_key.rb</a>
+<a href="../files/lib/facets/core/hash/to_h_rb.html">lib/facets/core/hash/to_h.rb</a>
+<a href="../files/lib/facets/core/hash/variablize_keys_rb.html">lib/facets/core/hash/variablize_keys.rb</a>
+<a href="../files/lib/facets/core/hash/slice_rb.html">lib/facets/core/hash/slice.rb</a>
+<a href="../files/lib/facets/core/hash/traverse_rb.html">lib/facets/core/hash/traverse.rb</a>
+<a href="../files/lib/facets/core/hash/shuffle_rb.html">lib/facets/core/hash/shuffle.rb</a>
+<a href="../files/lib/facets/core/hash/alias_rb.html">lib/facets/core/hash/alias.rb</a>
+<a href="../files/lib/facets/core/hash/op_fetch_rb.html">lib/facets/core/hash/op_fetch.rb</a>
+<a href="../files/lib/facets/core/hash/has_keys_rb.html">lib/facets/core/hash/has_keys.rb</a>
+<a href="../files/lib/facets/core/hash/to_ostruct_recurse_rb.html">lib/facets/core/hash/to_ostruct_recurse.rb</a>
+<a href="../files/lib/facets/core/hash/swapkey_rb.html">lib/facets/core/hash/swapkey.rb</a>
+<a href="../files/lib/facets/core/hash/keys_to_s_rb.html">lib/facets/core/hash/keys_to_s.rb</a>
+<a href="../files/lib/facets/core/hash/weave_rb.html">lib/facets/core/hash/weave.rb</a>
+<a href="../files/lib/facets/core/hash/op_lshift_rb.html">lib/facets/core/hash/op_lshift.rb</a>
+<a href="../files/lib/facets/core/hash/update_keys_rb.html">lib/facets/core/hash/update_keys.rb</a>
+<a href="../files/lib/facets/core/hash/rand_pair_rb.html">lib/facets/core/hash/rand_pair.rb</a>
+<a href="../files/lib/facets/core/hash/update_each_rb.html">lib/facets/core/hash/update_each.rb</a>
+<a href="../files/lib/facets/core/hash/to_proc_rb.html">lib/facets/core/hash/to_proc.rb</a>
+<a href="../files/lib/facets/core/hash/self/zipnew_rb.html">lib/facets/core/hash/self/zipnew.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>
+  <ul>
+  <li><a href="#M000084">[]</a></li>
+  <li><a href="#M000085">[]=</a></li>
+  <li><a href="#M000083">alias!</a></li>
+  <li><a href="#M000050">assert_has_keys</a></li>
+  <li><a href="#M000064">assert_has_only_keys</a></li>
+  <li><a href="#M000062">at_rand</a></li>
+  <li><a href="#M000063">at_rand!</a></li>
+  <li><a href="#M000048">collate</a></li>
+  <li><a href="#M000049">collate!</a></li>
+  <li><a href="#M000069">delete_unless</a></li>
+  <li><a href="#M000053">each</a></li>
+  <li><a href="#M000054">each_with_index</a></li>
+  <li><a href="#M000051">each_with_key</a></li>
+  <li><a href="#M000055">graph!</a></li>
+  <li><a href="#M000086">has_keys?</a></li>
+  <li><a href="#M000070">has_only_keys?</a></li>
+  <li><a href="#M000058">inverse</a></li>
+  <li><a href="#M000052">join</a></li>
+  <li><a href="#M000089">keys_to_s</a></li>
+  <li><a href="#M000091">keys_to_s!</a></li>
+  <li><a href="#M000065">keys_to_sym</a></li>
+  <li><a href="#M000067">keys_to_sym!</a></li>
+  <li><a href="#M000061">pick</a></li>
+  <li><a href="#M000075">pick_key</a></li>
+  <li><a href="#M000097">pick_pair</a></li>
+  <li><a href="#M000073">rand_key</a></li>
+  <li><a href="#M000074">rand_key!</a></li>
+  <li><a href="#M000095">rand_pair</a></li>
+  <li><a href="#M000096">rand_pair!</a></li>
+  <li><a href="#M000059">rand_value</a></li>
+  <li><a href="#M000060">rand_value!</a></li>
+  <li><a href="#M000071">replace_each</a></li>
+  <li><a href="#M000081">shuffle</a></li>
+  <li><a href="#M000082">shuffle!</a></li>
+  <li><a href="#M000090">stringify_keys</a></li>
+  <li><a href="#M000092">stringify_keys!</a></li>
+  <li><a href="#M000072">swap!</a></li>
+  <li><a href="#M000088">swapkey!</a></li>
+  <li><a href="#M000066">symbolize_keys</a></li>
+  <li><a href="#M000068">symbolize_keys!</a></li>
+  <li><a href="#M000076">to_h</a></li>
+  <li><a href="#M000056">to_ostruct</a></li>
+  <li><a href="#M000087">to_ostruct_recurse</a></li>
+  <li><a href="#M000099">to_proc</a></li>
+  <li><a href="#M000100">to_proc_with_reponse</a></li>
+  <li><a href="#M000079">traverse</a></li>
+  <li><a href="#M000080">traverse!</a></li>
+  <li><a href="#M000098">update_each</a></li>
+  <li><a href="#M000094">update_keys</a></li>
+  <li><a href="#M000057">update_values</a></li>
+  <li><a href="#M000077">variablize_keys</a></li>
+  <li><a href="#M000078">variablize_keys!</a></li>
+  <li><a href="#M000093">weave</a></li>
+  <li><a href="#M000101">zipnew</a></li>
+  </ul>
+<div class="sectiontitle">Public Class methods</div>
+<div class="method">
+  <div class="title">
+    <a name="M000101"></a><b>zipnew</b>(keys,values)
+  </div>
+  <div class="description">
+  <p>
+Creates a new hash from two arrays &#8212;a keys array and a values array.
+</p>
+<pre>
+  Hash.zipnew([&quot;a&quot;,&quot;b&quot;,&quot;c&quot;], [1,2,3])
+    #=&gt; { &quot;a&quot;=&gt;1, &quot;b&quot;=&gt;2, &quot;c&quot;=&gt;3 }
+</pre>
+  </div>
+<div class="sourcecode">
+  <p class="source-link">[ <a href="javascript:toggleSource('M000101_source')" id="l_M000101_source">show source</a> ]</p>
+  <div id="M000101_source" class="dyn-source">
+<pre>
+<span class="ruby-comment cmt"># File lib/facets/core/hash/self/zipnew.rb, line 9</span>
+  <span class="ruby-keyword kw">def</span> <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">zipnew</span>(<span class="ruby-identifier">keys</span>,<span class="ruby-identifier">values</span>) <span class="ruby-comment cmt"># or some better name</span>
+    <span class="ruby-identifier">h</span> = {}
+    <span class="ruby-identifier">keys</span>.<span class="ruby-identifier">size</span>.<span class="ruby-identifier">times</span>{ <span class="ruby-operator">|</span><span class="ruby-identifier">i</span><span class="ruby-operator">|</span> <span class="ruby-identifier">h</span>[ <span class="ruby-identifier">keys</span>[<span class="ruby-identifier">i</span>] ] = <span class="ruby-identifier">values</span>[<span class="ruby-identifier">i</span>] }
+    <span class="ruby-identifier">h</span>
+  <span class="ruby-keyword kw">end</span>
+</pre>
+  </div>
+</div>
+</div>
+<div class="sectiontitle">Public Instance methods</div>
+<div class="method">
+  <div class="title">
+    <a name="M000084"></a><b>[]</b>( *sliceKeys )
+  </div>
+  <div class="description">
+  <p>
+Adds slicing to <a href="Hash.html">Hash</a>#[]. If more than one key
+arguments is given to <tt><a href="Hash.html">Hash</a>#[]</tt>, the return
+value will be an array of the corresponding values.
+</p>
+<pre>
+  h = { :a =&gt; 1, :b =&gt; 2, :c =&gt; 3 }
+  h[:a]            #=&gt; 1
+  h[:a, :b]        #=&gt; [1,2]
+</pre>
+  </div>
+<div class="sourcecode">
+  <p class="source-link">[ <a href="javascript:toggleSource('M000084_source')" id="l_M000084_source">show source</a> ]</p>
+  <div id="M000084_source" class="dyn-source">
+<pre>
+<span class="ruby-comment cmt"># File lib/facets/core/hash/op_fetch.rb, line 13</span>
+  <span class="ruby-keyword kw">def</span> <span class="ruby-operator">[]</span>( <span class="ruby-operator">*</span><span class="ruby-identifier">sliceKeys</span> )
+    <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">sliceKeys</span>.<span class="ruby-identifier">length</span> <span class="ruby-operator">==</span> <span class="ruby-value">1</span>
+      <span class="ruby-keyword kw">return</span> <span class="ruby-identifier">at</span>( <span class="ruby-identifier">sliceKeys</span>[<span class="ruby-value">0</span>] )
+    <span class="ruby-keyword kw">else</span>
+      <span class="ruby-keyword kw">return</span> <span class="ruby-identifier">values_at</span>( <span class="ruby-operator">*</span><span class="ruby-identifier">sliceKeys</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="M000085"></a><b>[]=</b>( *args )
+  </div>
+  <div class="description">
+  <p>
+Add slicing to element assignment operator.
+</p>
+<pre>
+  h = {:a=&gt;1, :b=&gt;2, :c=&gt;3}
+  h[:a] = 9              #=&gt; 9
+  h                      #=&gt; {:a=&gt;9, :b=&gt;2, :c=&gt;3}
+  h[:a, :c] = [10,11]    #=&gt; [10,11]
+  h                      #=&gt; {:a=&gt;10, :b=&gt;2, :c=&gt;11}
+</pre>
+  </div>
+<div class="sourcecode">
+  <p class="source-link">[ <a href="javascript:toggleSource('M000085_source')" id="l_M000085_source">show source</a> ]</p>
+  <div id="M000085_source" class="dyn-source">
+<pre>
+<span class="ruby-comment cmt"># File lib/facets/core/hash/op_fetch.rb, line 31</span>
+  <span class="ruby-keyword kw">def</span> <span class="ruby-operator">[]=</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">length</span> <span class="ruby-operator">&lt;=</span> <span class="ruby-value">2</span>
+      <span class="ruby-keyword kw">return</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-identifier">aVals</span> = <span class="ruby-identifier">args</span>.<span class="ruby-identifier">pop</span>
+    <span class="ruby-identifier">aVals</span> = [<span class="ruby-identifier">aVals</span>] <span class="ruby-keyword kw">unless</span> <span class="ruby-identifier">aVals</span>.<span class="ruby-identifier">kind_of?</span>( <span class="ruby-constant">Array</span> )
+    <span class="ruby-identifier">args</span>.<span class="ruby-identifier">each_index</span>{ <span class="ruby-operator">|</span><span class="ruby-identifier">i</span><span class="ruby-operator">|</span> <span class="ruby-identifier">store</span>( <span class="ruby-identifier">args</span>[<span class="ruby-identifier">i</span>], <span class="ruby-identifier">aVals</span>[<span class="ruby-identifier">i</span>] ) }
+  <span class="ruby-keyword kw">end</span>
+</pre>
+  </div>
+</div>
+</div>
+<div class="method">
+  <div class="title">
+    <a name="M000083"></a><b>alias!</b>( newkey, oldkey )
+  </div>
+  <div class="description">
+  <p>
+Modifies the receiving <a href="Hash.html">Hash</a> so that the value
+previously referred to by <em>oldkey</em> is also referenced by
+<em>newkey</em>; <em>oldkey</em> is retained in the <a
+href="Hash.html">Hash</a>. If <em>oldkey</em> does not exist as a key in
+the <a href="Hash.html">Hash</a>, no change is effected.
+</p>
+<p>
+Returns a reference to the <a href="Hash.html">Hash</a>.
+</p>
+<pre>
+  foo = { :name=&gt;'Gavin', 'wife'=&gt;:Lisa }
+  foo.alias!('name',:name)     =&gt; { :name=&gt;'Gavin', 'name'=&gt;'Gavin', 'wife'=&gt;:Lisa }
+  foo = { :name=&gt;'Gavin', 'wife'=&gt;:Lisa }
+  foo.alias!('spouse','wife')  =&gt; { :name=&gt;'Gavin', 'wife'=&gt;:Lisa, 'spouse'=&gt;:Lisa }
+  foo = { :name=&gt;'Gavin', 'wife'=&gt;:Lisa }
+  foo.alias!('bar','foo')      =&gt; { :name=&gt;'Gavin', 'wife'=&gt;:Lisa }
+</pre>
+<p>
+Note that if the <em>oldkey</em> is reassigned, the reference will no
+longer exist, and the <em>newkey</em> will remain as it was.
+</p>
+  </div>
+<div class="sourcecode">
+  <p class="source-link">[ <a href="javascript:toggleSource('M000083_source')" id="l_M000083_source">show source</a> ]</p>
+  <div id="M000083_source" class="dyn-source">
+<pre>
+<span class="ruby-comment cmt"># File lib/facets/core/hash/alias.rb, line 23</span>
+  <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">alias!</span>( <span class="ruby-identifier">newkey</span>, <span class="ruby-identifier">oldkey</span> )
+    <span class="ruby-keyword kw">self</span>[<span class="ruby-identifier">newkey</span>] = <span class="ruby-keyword kw">self</span>[<span class="ruby-identifier">oldkey</span>] <span class="ruby-keyword kw">if</span> <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">has_key?</span>(<span class="ruby-identifier">oldkey</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="M000050"></a><b>assert_has_keys</b>(*check_keys)
+  </div>
+  <div class="description">
+  <p>
+Returns true is hash has the given keys, otherwise throws an ArgumentError.
+</p>
+<pre>
+  h = { :a =&gt; 1, :b =&gt; 2 }
+  h.assert_has_keys( :a )   #=&gt; true
+  h.assert_has_keys( :c )   #=&gt; ArgumentError
+</pre>
+  </div>
+<div class="sourcecode">
+  <p class="source-link">[ <a href="javascript:toggleSource('M000050_source')" id="l_M000050_source">show source</a> ]</p>
+  <div id="M000050_source" class="dyn-source">
+<pre>
+<span class="ruby-comment cmt"># File lib/facets/core/hash/assert_has_keys.rb, line 12</span>
+  <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">assert_has_keys</span>(<span class="ruby-operator">*</span><span class="ruby-identifier">check_keys</span>)
+    <span class="ruby-identifier">raise</span>(<span class="ruby-constant">ArgumentError</span>, <span class="ruby-value str">&quot;does not have key(s)&quot;</span>) <span class="ruby-keyword kw">unless</span> <span class="ruby-identifier">has_keys?</span>(<span class="ruby-operator">*</span><span class="ruby-identifier">check_keys</span>)
+  <span class="ruby-keyword kw">end</span>
+</pre>
+  </div>
+</div>
+</div>
+<div class="method">
+  <div class="title">
+    <a name="M000064"></a><b>assert_has_only_keys</b>(*check_keys)
+  </div>
+  <div class="description">
+  <p>
+Returns true is hash has only then given keys, otherwise throws an
+ArgumentError.
+</p>
+<pre>
+  h = { :a =&gt; 1, :b =&gt; 2 }
+  h.assert_has_only_keys( :a, :b )   #=&gt; true
+  h.assert_has_only_keys( :a )       #=&gt; ArgumentError
+</pre>
+  </div>
+<div class="sourcecode">
+  <p class="source-link">[ <a href="javascript:toggleSource('M000064_source')" id="l_M000064_source">show source</a> ]</p>
+  <div id="M000064_source" class="dyn-source">
+<pre>
+<span class="ruby-comment cmt"># File lib/facets/core/hash/assert_has_only_keys.rb, line 12</span>
+  <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">assert_has_only_keys</span>(<span class="ruby-operator">*</span><span class="ruby-identifier">check_keys</span>)
+    <span class="ruby-identifier">raise</span>(<span class="ruby-constant">ArgumentError</span>, <span class="ruby-value str">&quot;has unexpected key(s)&quot;</span>) <span class="ruby-keyword kw">unless</span> <span class="ruby-identifier">has_only_keys?</span>(<span class="ruby-operator">*</span><span class="ruby-identifier">check_keys</span>)
+  <span class="ruby-keyword kw">end</span>
+</pre>
+  </div>
+</div>
+</div>
+<div class="method">
+  <div class="title">
+    <a name="M000062"></a><b>at_rand</b>()
+  </div>
+  <div class="description">
+  <p>
+Alias for <a href="Hash.html#M000059">rand_value</a>
+</p>
+  </div>
+</div>
+<div class="method">
+  <div class="title">
+    <a name="M000063"></a><b>at_rand!</b>()
+  </div>
+  <div class="description">
+  <p>
+Alias for <a href="Hash.html#M000060">rand_value!</a>
+</p>
+  </div>
+</div>
+<div class="method">
+  <div class="title">
+    <a name="M000048"></a><b>collate</b>( {|| ...}
+  </div>
+  <div class="description">
+  <p>
+Returns a new hash built by iterating through each key,value pair and
+updating the new hash.
+</p>
+  </div>
+<div class="sourcecode">
+  <p class="source-link">[ <a href="javascript:toggleSource('M000048_source')" id="l_M000048_source">show source</a> ]</p>
+  <div id="M000048_source" class="dyn-source">
+<pre>
+<span class="ruby-comment cmt"># File lib/facets/core/hash/collate.rb, line 12</span>
+  <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">collate</span>  <span class="ruby-comment cmt"># :yield:</span>
+    <span class="ruby-identifier">newhash</span> = {}
+    <span class="ruby-identifier">each_pair</span>{ <span class="ruby-operator">|</span><span class="ruby-identifier">k</span>,<span class="ruby-identifier">v</span><span class="ruby-operator">|</span> <span class="ruby-identifier">newhash</span>.<span class="ruby-identifier">update</span>( <span class="ruby-keyword kw">yield</span>(<span class="ruby-identifier">k</span>,<span class="ruby-identifier">v</span>) ) }
+    <span class="ruby-identifier">newhash</span>
+  <span class="ruby-keyword kw">end</span>
+</pre>
+  </div>
+</div>
+</div>
+<div class="method">
+  <div class="title">
+    <a name="M000049"></a><b>collate!</b>(&amp;yld)
+  </div>
+  <div class="description">
+  <p>
+In place version of <a href="Hash.html#M000048">collate</a>.
+</p>
+  </div>
+<div class="sourcecode">
+  <p class="source-link">[ <a href="javascript:toggleSource('M000049_source')" id="l_M000049_source">show source</a> ]</p>
+  <div id="M000049_source" class="dyn-source">
+<pre>
+<span class="ruby-comment cmt"># File lib/facets/core/hash/collate.rb, line 19</span>
+  <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">collate!</span>(<span class="ruby-operator">&amp;</span><span class="ruby-identifier">yld</span>)
+    <span class="ruby-identifier">replace</span>( <span class="ruby-identifier">collate</span>(<span class="ruby-operator">&amp;</span><span class="ruby-identifier">yld</span>) )
+  <span class="ruby-keyword kw">end</span>
+</pre>
+  </div>
+</div>
+</div>
+<div class="method">
+  <div class="title">
+    <a name="M000069"></a><b>delete_unless</b>(&amp;block)
+  </div>
+<div class="sourcecode">
+  <p class="source-link">[ <a href="javascript:toggleSource('M000069_source')" id="l_M000069_source">show source</a> ]</p>
+  <div id="M000069_source" class="dyn-source">
+<pre>
+<span class="ruby-comment cmt"># File lib/facets/core/hash/delete_unless.rb, line 3</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">key</span>, <span class="ruby-identifier">value</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">key</span>, <span class="ruby-identifier">value</span>) }
+  <span class="ruby-keyword kw">end</span>
+</pre>
+  </div>
+</div>
+</div>
+<div class="method">
+  <div class="title">
+    <a name="M000053"></a><b>each</b>() {|v| ...}
+  </div>
+  <div class="description">
+  <p>
+A &quot;smarter&quot; hash<a href="Hash.html#M000053">each</a> which
+iterates through each <em>value</em> if only one block parameter is given.
+</p>
+<pre>
+  {:a=&gt;&quot;a&quot;, 2=&gt;&quot;b&quot;, &quot;x&quot;=&gt;&quot;c&quot;}.each{ |v| puts v }
+</pre>
+<p>
+<em>produces</em>
+</p>
+<pre>
+  a
+  b
+  c
+</pre>
+<p>
+WARNING! Use with caution. Methods from other libraries may depend on the
+old behavior, expecting a two element array to be passed into a single
+block argument.
+</p>
+  </div>
+<div class="sourcecode">
+  <p class="source-link">[ <a href="javascript:toggleSource('M000053_source')" id="l_M000053_source">show source</a> ]</p>
+  <div id="M000053_source" class="dyn-source">
+<pre>
+<span class="ruby-comment cmt"># File lib/facets/core/hash/each.rb, line 19</span>
+  <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">each</span>(<span class="ruby-operator">&amp;</span><span class="ruby-identifier">yld</span>)
+    <span class="ruby-keyword kw">case</span> <span class="ruby-identifier">yld</span>.<span class="ruby-identifier">arity</span>
+    <span class="ruby-keyword kw">when</span> <span class="ruby-value">0</span>
+    <span class="ruby-keyword kw">when</span> <span class="ruby-value">1</span>
+      <span class="ruby-identifier">each_value</span>{<span class="ruby-operator">|</span><span class="ruby-identifier">v</span><span class="ruby-operator">|</span> <span class="ruby-keyword kw">yield</span>(<span class="ruby-identifier">v</span>)}
+    <span class="ruby-keyword kw">else</span>
+      <span class="ruby-identifier">each_pair</span>{<span class="ruby-operator">|</span><span class="ruby-identifier">k</span>,<span class="ruby-identifier">v</span><span class="ruby-operator">|</span> <span class="ruby-identifier">yld</span>.<span class="ruby-identifier">call</span>(<span class="ruby-identifier">k</span>,<span class="ruby-identifier">v</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="M000054"></a><b>each_with_index</b>( &amp;yld )
+  </div>
+  <div class="description">
+  <p>
+Alias for <a href="Hash.html#M000051">each_with_key</a>
+</p>
+  </div>
+</div>
+<div class="method">
+  <div class="title">
+    <a name="M000051"></a><b>each_with_key</b>( &amp;yld )
+  </div>
+<div class="aka">
+  This method is also aliased as
+  <a href="Hash.html#M000054">each_with_index</a>
+</div>
+<div class="sourcecode">
+  <p class="source-link">[ <a href="javascript:toggleSource('M000051_source')" id="l_M000051_source">show source</a> ]</p>
+  <div id="M000051_source" class="dyn-source">
+<pre>
+<span class="ruby-comment cmt"># File lib/facets/core/hash/each_with_key.rb, line 4</span>
+  <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">each_with_key</span>( <span class="ruby-operator">&amp;</span><span class="ruby-identifier">yld</span> )
+    <span class="ruby-identifier">each_pair</span>{ <span class="ruby-operator">|</span><span class="ruby-identifier">k</span>,<span class="ruby-identifier">v</span><span class="ruby-operator">|</span> <span class="ruby-identifier">yld</span>.<span class="ruby-identifier">call</span>(<span class="ruby-identifier">v</span>,<span class="ruby-identifier">k</span>) }
+  <span class="ruby-keyword kw">end</span>
+</pre>
+  </div>
+</div>
+</div>
+<div class="method">
+  <div class="title">
+    <a name="M000055"></a><b>graph!</b>( &amp;blk )
+  </div>
+  <div class="description">
+  <p>
+As with <a href="Enumerable.html#M000469">Enumerable#graph</a> but acts in
+place.
+</p>
+  </div>
+<div class="sourcecode">
+  <p class="source-link">[ <a href="javascript:toggleSource('M000055_source')" id="l_M000055_source">show source</a> ]</p>
+  <div id="M000055_source" class="dyn-source">
+<pre>
+<span class="ruby-comment cmt"># File lib/facets/core/hash/graph.rb, line 5</span>
+  <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">graph!</span>( <span class="ruby-operator">&amp;</span><span class="ruby-identifier">blk</span> )
+    <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">replace</span>( <span class="ruby-identifier">graph</span>( <span class="ruby-operator">&amp;</span><span class="ruby-identifier">blk</span> ) )
+  <span class="ruby-keyword kw">end</span>
+</pre>
+  </div>
+</div>
+</div>
+<div class="method">
+  <div class="title">
+    <a name="M000086"></a><b>has_keys?</b>(*check_keys)
+  </div>
+  <div class="description">
+  <p>
+Returns true or false whether the hash contains the given keys.
+</p>
+<pre>
+  h = { :a =&gt; 1, :b =&gt; 2 }
+  h.has_keys?( :a )   #=&gt; true
+  h.has_keys?( :c )   #=&gt; false
+</pre>
+  </div>
+<div class="sourcecode">
+  <p class="source-link">[ <a href="javascript:toggleSource('M000086_source')" id="l_M000086_source">show source</a> ]</p>
+  <div id="M000086_source" class="dyn-source">
+<pre>
+<span class="ruby-comment cmt"># File lib/facets/core/hash/has_keys.rb, line 10</span>
+  <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">has_keys?</span>(<span class="ruby-operator">*</span><span class="ruby-identifier">check_keys</span>)
+    <span class="ruby-identifier">unknown_keys</span> = <span class="ruby-identifier">check_keys</span> <span class="ruby-operator">-</span> <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">keys</span>
+    <span class="ruby-keyword kw">return</span> <span class="ruby-identifier">unknown_keys</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="M000070"></a><b>has_only_keys?</b>(*check_keys)
+  </div>
+  <div class="description">
+  <p>
+Returns true if the hash contains <em>only</em> the given keys, otherwise
+false.
+</p>
+<pre>
+  h = { :a =&gt; 1, :b =&gt; 2 }
+  h.has_only_keys?( :a, :b )   #=&gt; true
+  h.has_only_keys?( :a )       #=&gt; false
+</pre>
+  </div>
+<div class="sourcecode">
+  <p class="source-link">[ <a href="javascript:toggleSource('M000070_source')" id="l_M000070_source">show source</a> ]</p>
+  <div id="M000070_source" class="dyn-source">
+<pre>
+<span class="ruby-comment cmt"># File lib/facets/core/hash/has_only_keys.rb, line 10</span>
+  <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">has_only_keys?</span>(<span class="ruby-operator">*</span><span class="ruby-identifier">check_keys</span>)
+    <span class="ruby-identifier">unknown_keys</span> = <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">keys</span> <span class="ruby-operator">-</span> <span class="ruby-identifier">check_keys</span>
+    <span class="ruby-keyword kw">return</span> <span class="ruby-identifier">unknown_keys</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="M000058"></a><b>inverse</b>()
+  </div>
+  <div class="description">
+  <p>
+Create a &quot;true&quot; inverse hash by storing mutliple values in
+Arrays.
+</p>
+<pre>
+  h = {&quot;a&quot;=&gt;3, &quot;b&quot;=&gt;3, &quot;c&quot;=&gt;3, &quot;d&quot;=&gt;2, &quot;e&quot;=&gt;9, &quot;f&quot;=&gt;3, &quot;g&quot;=&gt;9}
+  h.invert                #=&gt; {2=&gt;&quot;d&quot;, 3=&gt;&quot;f&quot;, 9=&gt;&quot;g&quot;}
+  h.inverse               #=&gt; {2=&gt;&quot;d&quot;, 3=&gt;[&quot;f&quot;, &quot;c&quot;, &quot;b&quot;, &quot;a&quot;], 9=&gt;[&quot;g&quot;, &quot;e&quot;]}
+  h.inverse.inverse       #=&gt; {&quot;a&quot;=&gt;3, &quot;b&quot;=&gt;3, &quot;c&quot;=&gt;3, &quot;d&quot;=&gt;2, &quot;e&quot;=&gt;9, &quot;f&quot;=&gt;3, &quot;g&quot;=&gt;9}
+  h.inverse.inverse == h  #=&gt; true
+</pre>
+  </div>
+<div class="sourcecode">
+  <p class="source-link">[ <a href="javascript:toggleSource('M000058_source')" id="l_M000058_source">show source</a> ]</p>
+  <div id="M000058_source" class="dyn-source">
+<pre>
+<span class="ruby-comment cmt"># File lib/facets/core/hash/inverse.rb, line 16</span>
+  <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">inverse</span>
+    <span class="ruby-identifier">i</span> = <span class="ruby-constant">Hash</span>.<span class="ruby-identifier">new</span>
+    <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">each_pair</span>{ <span class="ruby-operator">|</span><span class="ruby-identifier">k</span>,<span class="ruby-identifier">v</span><span class="ruby-operator">|</span>
+      <span class="ruby-keyword kw">if</span> (<span class="ruby-constant">Array</span> <span class="ruby-operator">===</span> <span class="ruby-identifier">v</span>)
+        <span class="ruby-identifier">v</span>.<span class="ruby-identifier">each</span>{ <span class="ruby-operator">|</span><span class="ruby-identifier">x</span><span class="ruby-operator">|</span> <span class="ruby-identifier">i</span>[<span class="ruby-identifier">x</span>] = ( <span class="ruby-identifier">i</span>.<span class="ruby-identifier">has_key?</span>(<span class="ruby-identifier">x</span>) <span class="ruby-operator">?</span> [<span class="ruby-identifier">k</span>,<span class="ruby-identifier">i</span>[<span class="ruby-identifier">x</span>]].<span class="ruby-identifier">flatten</span> <span class="ruby-operator">:</span> <span class="ruby-identifier">k</span> ) }
+      <span class="ruby-keyword kw">else</span>
+        <span class="ruby-identifier">i</span>[<span class="ruby-identifier">v</span>] = ( <span class="ruby-identifier">i</span>.<span class="ruby-identifier">has_key?</span>(<span class="ruby-identifier">v</span>) <span class="ruby-operator">?</span> [<span class="ruby-identifier">k</span>,<span class="ruby-identifier">i</span>[<span class="ruby-identifier">v</span>]].<span class="ruby-identifier">flatten</span> <span class="ruby-operator">:</span> <span class="ruby-identifier">k</span> )
+      <span class="ruby-keyword kw">end</span>
+    }
+    <span class="ruby-keyword kw">return</span> <span class="ruby-identifier">i</span>
+  <span class="ruby-keyword kw">end</span>
+</pre>
+  </div>
+</div>
+</div>
+<div class="method">
+  <div class="title">
+    <a name="M000052"></a><b>join</b>( pair_divider='', elem_divider='' )
+  </div>
+<div class="sourcecode">
+  <p class="source-link">[ <a href="javascript:toggleSource('M000052_source')" id="l_M000052_source">show source</a> ]</p>
+  <div id="M000052_source" class="dyn-source">
+<pre>
+<span class="ruby-comment cmt"># File lib/facets/core/hash/join.rb, line 4</span>
+  <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">join</span>( <span class="ruby-identifier">pair_divider</span>=<span class="ruby-value str">''</span>, <span class="ruby-identifier">elem_divider</span>=<span class="ruby-value str">''</span> )
+    <span class="ruby-identifier">s</span> = []
+    <span class="ruby-identifier">each_pair</span> { <span class="ruby-operator">|</span><span class="ruby-identifier">k</span>,<span class="ruby-identifier">v</span><span class="ruby-operator">|</span> <span class="ruby-identifier">s</span> <span class="ruby-operator">&lt;&lt;</span> <span class="ruby-node">&quot;#{k}#{pair_divider}#{v}&quot;</span> }
+    <span class="ruby-identifier">s</span>.<span class="ruby-identifier">join</span>(<span class="ruby-identifier">elem_divider</span>)
+  <span class="ruby-keyword kw">end</span>
+</pre>
+  </div>
+</div>
+</div>
+<div class="method">
+  <div class="title">
+    <a name="M000089"></a><b>keys_to_s</b>( from_class=nil )
+  </div>
+  <div class="description">
+  <p>
+Converts all keys in the <a href="Hash.html">Hash</a> to be <a
+href="String.html">String</a> values, returning a new <a
+href="Hash.html">Hash</a>. With a from_class parameter, limits conversion
+to only a certain class of keys. It defaults to nil which convert any key
+class.
+</p>
+<pre>
+  foo = { :name=&gt;'Gavin', :wife=&gt;:Lisa }
+  foo.keys_to_s    #=&gt;  { &quot;name&quot;=&gt;&quot;Gavin&quot;, &quot;wife&quot;=&gt;:Lisa }
+  foo.inspect      #=&gt;  { :name =&gt;&quot;Gavin&quot;, :wife=&gt;:Lisa }
+</pre>
+  </div>
+<div class="aka">
+  This method is also aliased as
+  <a href="Hash.html#M000090">stringify_keys</a>
+</div>
+<div class="sourcecode">
+  <p class="source-link">[ <a href="javascript:toggleSource('M000089_source')" id="l_M000089_source">show source</a> ]</p>
+  <div id="M000089_source" class="dyn-source">
+<pre>
+<span class="ruby-comment cmt"># File lib/facets/core/hash/keys_to_s.rb, line 15</span>
+  <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">keys_to_s</span>( <span class="ruby-identifier">from_class</span>=<span class="ruby-keyword kw">nil</span> )
+    <span class="ruby-identifier">raise</span> <span class="ruby-constant">ArgumentError</span>, <span class="ruby-value str">&quot;Parameter must be a class&quot;</span> <span class="ruby-keyword kw">unless</span> <span class="ruby-identifier">from_class</span>.<span class="ruby-identifier">kind_of?</span>(<span class="ruby-constant">Class</span>) <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">from_class</span>
+    <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">dup</span>.<span class="ruby-identifier">keys_to_s!</span>( <span class="ruby-identifier">from_class</span> )
+  <span class="ruby-keyword kw">end</span>
+</pre>
+  </div>
+</div>
+</div>
+<div class="method">
+  <div class="title">
+    <a name="M000091"></a><b>keys_to_s!</b>( from_class=nil )
+  </div>
+  <div class="description">
+  <p>
+Synonym for Hash#keys_to_string, but modifies the receiver in place (and
+returns it). With a from_class parameter, limits conversion to only a
+certain class of keys. It defaults to nil which convert any key class.
+</p>
+<pre>
+  foo = { :name=&gt;'Gavin', :wife=&gt;:Lisa }
+  foo.keys_to_s!    #=&gt;  { &quot;name&quot;=&gt;&quot;Gavin&quot;, &quot;wife&quot;=&gt;:Lisa }
+  foo.inspect       #=&gt;  { &quot;name&quot;=&gt;&quot;Gavin&quot;, &quot;wife&quot;=&gt;:Lisa }
+</pre>
+  </div>
+<div class="aka">
+  This method is also aliased as
+  <a href="Hash.html#M000092">stringify_keys!</a>
+</div>
+<div class="sourcecode">
+  <p class="source-link">[ <a href="javascript:toggleSource('M000091_source')" id="l_M000091_source">show source</a> ]</p>
+  <div id="M000091_source" class="dyn-source">
+<pre>
+<span class="ruby-comment cmt"># File lib/facets/core/hash/keys_to_s.rb, line 34</span>
+  <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">keys_to_s!</span>( <span class="ruby-identifier">from_class</span>=<span class="ruby-keyword kw">nil</span> )
+    <span class="ruby-identifier">raise</span> <span class="ruby-constant">ArgumentError</span>, <span class="ruby-value str">&quot;Parameter must be a class&quot;</span> <span class="ruby-keyword kw">unless</span> <span class="ruby-identifier">from_class</span>.<span class="ruby-identifier">kind_of?</span>(<span class="ruby-constant">Class</span>) <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">from_class</span>
+    <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">from_class</span>
+      <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">each_key</span>{ <span class="ruby-operator">|</span><span class="ruby-identifier">k</span><span class="ruby-operator">|</span>
+        <span class="ruby-keyword kw">self</span>[<span class="ruby-identifier">k</span>.<span class="ruby-identifier">to_s</span>]=<span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">delete</span>(<span class="ruby-identifier">k</span>) <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">k</span>.<span class="ruby-identifier">respond_to?</span>(<span class="ruby-identifier">:to_s</span>) <span class="ruby-keyword kw">and</span> <span class="ruby-identifier">k</span>.<span class="ruby-identifier">class</span> <span class="ruby-operator">==</span> <span class="ruby-identifier">from_class</span>
+      }
+    <span class="ruby-keyword kw">else</span>
+      <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">each_key</span>{ <span class="ruby-operator">|</span><span class="ruby-identifier">k</span><span class="ruby-operator">|</span>
+        <span class="ruby-keyword kw">self</span>[<span class="ruby-identifier">k</span>.<span class="ruby-identifier">to_s</span>]=<span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">delete</span>(<span class="ruby-identifier">k</span>) <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">k</span>.<span class="ruby-identifier">respond_to?</span>(<span class="ruby-identifier">:to_s</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="M000065"></a><b>keys_to_sym</b>( from_class=String )
+  </div>
+  <div class="description">
+  <p>
+Converts all keys in the <a href="Hash.html">Hash</a> to be <a
+href="Symbol.html">Symbol</a> values, returning a new <a
+href="Hash.html">Hash</a>. With a from_class parameter, limits conversion
+to only a certain class of keys. It defaults to <a
+href="String.html">String</a> &#8212;use nil to convert any key class.
+</p>
+<pre>
+  foo = { :name=&gt;'Gavin', 'wife'=&gt;:Lisa }
+  foo.keys_to_sym    #=&gt;  { :name=&gt;&quot;Gavin&quot;, :wife=&gt;:Lisa }
+  foo.inspect        #=&gt;  { &quot;name&quot; =&gt;&quot;Gavin&quot;, &quot;wife&quot;=&gt;:Lisa }
+</pre>
+  </div>
+<div class="aka">
+  This method is also aliased as
+  <a href="Hash.html#M000066">symbolize_keys</a>
+</div>
+<div class="sourcecode">
+  <p class="source-link">[ <a href="javascript:toggleSource('M000065_source')" id="l_M000065_source">show source</a> ]</p>
+  <div id="M000065_source" class="dyn-source">
+<pre>
+<span class="ruby-comment cmt"># File lib/facets/core/hash/keys_to_sym.rb, line 15</span>
+  <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">keys_to_sym</span>( <span class="ruby-identifier">from_class</span>=<span class="ruby-constant">String</span> )
+    <span class="ruby-identifier">raise</span> <span class="ruby-constant">ArgumentError</span>, <span class="ruby-value str">&quot;Parameter must be a class&quot;</span> <span class="ruby-keyword kw">unless</span> <span class="ruby-identifier">from_class</span>.<span class="ruby-identifier">kind_of?</span>(<span class="ruby-constant">Class</span>) <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">from_class</span>
+    <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">dup</span>.<span class="ruby-identifier">keys_to_sym!</span>( <span class="ruby-identifier">from_class</span> )
+  <span class="ruby-keyword kw">end</span>
+</pre>
+  </div>
+</div>
+</div>
+<div class="method">
+  <div class="title">
+    <a name="M000067"></a><b>keys_to_sym!</b>( from_class=String )
+  </div>
+  <div class="description">
+  <p>
+Synonym for Hash#keys_to_symbol, but modifies the receiver in place (and
+returns it). With a from_class parameter, limits conversion to only a
+certain class of keys. It defaults to <a href="String.html">String</a>
+&#8212;use nil to convert any key class.
+</p>
+<pre>
+  foo = { 'name'=&gt;'Gavin', 'wife'=&gt;:Lisa }
+  foo.keys_to_sym!    #=&gt;  { :name=&gt;&quot;Gavin&quot;, :wife=&gt;:Lisa }
+  foo.inspect         #=&gt;  { :name=&gt;&quot;Gavin&quot;, :wife=&gt;:Lisa }
+</pre>
+  </div>
+<div class="aka">
+  This method is also aliased as
+  <a href="Hash.html#M000068">symbolize_keys!</a>
+</div>
+<div class="sourcecode">
+  <p class="source-link">[ <a href="javascript:toggleSource('M000067_source')" id="l_M000067_source">show source</a> ]</p>
+  <div id="M000067_source" class="dyn-source">
+<pre>
+<span class="ruby-comment cmt"># File lib/facets/core/hash/keys_to_sym.rb, line 40</span>
+  <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">keys_to_sym!</span>( <span class="ruby-identifier">from_class</span>=<span class="ruby-constant">String</span> )
+    <span class="ruby-identifier">raise</span> <span class="ruby-constant">ArgumentError</span>, <span class="ruby-value str">&quot;Parameter must be a class&quot;</span> <span class="ruby-keyword kw">unless</span> <span class="ruby-identifier">from_class</span>.<span class="ruby-identifier">kind_of?</span>(<span class="ruby-constant">Class</span>) <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">from_class</span>
+    <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">from_class</span>
+      <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">each_key</span>{ <span class="ruby-operator">|</span><span class="ruby-identifier">k</span><span class="ruby-operator">|</span>
+        <span class="ruby-keyword kw">self</span>[<span class="ruby-identifier">k</span>.<span class="ruby-identifier">to_sym</span>]=<span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">delete</span>(<span class="ruby-identifier">k</span>) <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">k</span>.<span class="ruby-identifier">respond_to?</span>(<span class="ruby-identifier">:to_sym</span>) <span class="ruby-keyword kw">and</span> <span class="ruby-identifier">k</span>.<span class="ruby-identifier">class</span> <span class="ruby-operator">==</span> <span class="ruby-identifier">from_class</span>
+      }
+    <span class="ruby-keyword kw">else</span>
+      <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">each_key</span>{ <span class="ruby-operator">|</span><span class="ruby-identifier">k</span><span class="ruby-operator">|</span>
+        <span class="ruby-keyword kw">self</span>[<span class="ruby-identifier">k</span>.<span class="ruby-identifier">to_sym</span>]=<span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">delete</span>(<span class="ruby-identifier">k</span>) <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">k</span>.<span class="ruby-identifier">respond_to?</span>(<span class="ruby-identifier">:to_sym</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="M000061"></a><b>pick</b>()
+  </div>
+  <div class="description">
+  <p>
+Alias for <a href="Hash.html#M000060">rand_value!</a>
+</p>
+  </div>
+</div>
+<div class="method">
+  <div class="title">
+    <a name="M000075"></a><b>pick_key</b>()
+  </div>
+  <div class="description">
+  <p>
+Alias for <a href="Hash.html#M000074">rand_key!</a>
+</p>
+  </div>
+</div>
+<div class="method">
+  <div class="title">
+    <a name="M000097"></a><b>pick_pair</b>()
+  </div>
+  <div class="description">
+  <p>
+Alias for <a href="Hash.html#M000096">rand_pair!</a>
+</p>
+  </div>
+</div>
+<div class="method">
+  <div class="title">
+    <a name="M000073"></a><b>rand_key</b>()
+  </div>
+  <div class="description">
+  <p>
+Returns a random key.
+</p>
+<pre>
+  {:one =&gt; 1, :two =&gt; 2, :three =&gt; 3}.pick_key  #=&gt; :three
+</pre>
+  </div>
+<div class="sourcecode">
+  <p class="source-link">[ <a href="javascript:toggleSource('M000073_source')" id="l_M000073_source">show source</a> ]</p>
+  <div id="M000073_source" class="dyn-source">
+<pre>
+<span class="ruby-comment cmt"># File lib/facets/core/hash/rand_key.rb, line 7</span>
+  <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">rand_key</span>
+    <span class="ruby-identifier">keys</span>.<span class="ruby-identifier">at</span>( <span class="ruby-identifier">rand</span>(<span class="ruby-identifier">keys</span>.<span class="ruby-identifier">size</span>) )
+  <span class="ruby-keyword kw">end</span>
+</pre>
+  </div>
+</div>
+</div>
+<div class="method">
+  <div class="title">
+    <a name="M000074"></a><b>rand_key!</b>()
+  </div>
+  <div class="description">
+  <p>
+Delete a random key-value pair, returning the key.
+</p>
+<pre>
+  a = {:one =&gt; 1, :two =&gt; 2, :three =&gt; 3}
+  a.pick_key!  #=&gt; :two
+  a            #=&gt; {:one =&gt; 1, :three =&gt; 3}
+</pre>
+  </div>
+<div class="aka">
+  This method is also aliased as
+  <a href="Hash.html#M000075">pick_key</a>
+</div>
+<div class="sourcecode">
+  <p class="source-link">[ <a href="javascript:toggleSource('M000074_source')" id="l_M000074_source">show source</a> ]</p>
+  <div id="M000074_source" class="dyn-source">
+<pre>
+<span class="ruby-comment cmt"># File lib/facets/core/hash/rand_key.rb, line 17</span>
+  <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">rand_key!</span>
+    <span class="ruby-identifier">k</span>,<span class="ruby-identifier">v</span> = <span class="ruby-identifier">rand_pair</span>
+    <span class="ruby-identifier">delete</span>( <span class="ruby-identifier">k</span> )
+    <span class="ruby-keyword kw">return</span> <span class="ruby-identifier">k</span>
+  <span class="ruby-keyword kw">end</span>
+</pre>
+  </div>
+</div>
+</div>
+<div class="method">
+  <div class="title">
+    <a name="M000095"></a><b>rand_pair</b>()
+  </div>
+  <div class="description">
+  <p>
+Returns a random key-value pair.
+</p>
+<pre>
+  {:one =&gt; 1, :two =&gt; 2, :three =&gt; 3}.pick  #=&gt; [:one, 1]
+</pre>
+  </div>
+<div class="sourcecode">
+  <p class="source-link">[ <a href="javascript:toggleSource('M000095_source')" id="l_M000095_source">show source</a> ]</p>
+  <div id="M000095_source" class="dyn-source">
+<pre>
+<span class="ruby-comment cmt"># File lib/facets/core/hash/rand_pair.rb, line 9</span>
+  <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">rand_pair</span>
+    <span class="ruby-identifier">k</span> = <span class="ruby-identifier">rand_key</span>
+    <span class="ruby-keyword kw">return</span> <span class="ruby-identifier">k</span>, <span class="ruby-identifier">fetch</span>(<span class="ruby-identifier">k</span>)
+  <span class="ruby-keyword kw">end</span>
+</pre>
+  </div>
+</div>
+</div>
+<div class="method">
+  <div class="title">
+    <a name="M000096"></a><b>rand_pair!</b>()
+  </div>
+  <div class="description">
+  <p>
+Deletes a random key-value pair and returns that pair.
+</p>
+<pre>
+  a = {:one =&gt; 1, :two =&gt; 2, :three =&gt; 3}
+  a.rand_pair!  #=&gt; [:two, 2]
+  a             #=&gt; {:one =&gt; 1, :three =&gt; 3}
+</pre>
+  </div>
+<div class="aka">
+  This method is also aliased as
+  <a href="Hash.html#M000097">pick_pair</a>
+</div>
+<div class="sourcecode">
+  <p class="source-link">[ <a href="javascript:toggleSource('M000096_source')" id="l_M000096_source">show source</a> ]</p>
+  <div id="M000096_source" class="dyn-source">
+<pre>
+<span class="ruby-comment cmt"># File lib/facets/core/hash/rand_pair.rb, line 20</span>
+  <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">rand_pair!</span>
+    <span class="ruby-identifier">k</span>,<span class="ruby-identifier">v</span> = <span class="ruby-identifier">rand_pair</span>
+    <span class="ruby-identifier">delete</span>( <span class="ruby-identifier">k</span> )
+    <span class="ruby-keyword kw">return</span> <span class="ruby-identifier">k</span>,<span class="ruby-identifier">v</span>
+  <span class="ruby-keyword kw">end</span>
+</pre>
+  </div>
+</div>
+</div>
+<div class="method">
+  <div class="title">
+    <a name="M000059"></a><b>rand_value</b>()
+  </div>
+  <div class="description">
+  <p>
+Returns a random hash value.
+</p>
+<pre>
+  {:one =&gt; 1, :two =&gt; 2, :three =&gt; 3}.rand_value  #=&gt; 2
+  {:one =&gt; 1, :two =&gt; 2, :three =&gt; 3}.rand_value  #=&gt; 1
+</pre>
+  </div>
+<div class="aka">
+  This method is also aliased as
+  <a href="Hash.html#M000062">at_rand</a>
+</div>
+<div class="sourcecode">
+  <p class="source-link">[ <a href="javascript:toggleSource('M000059_source')" id="l_M000059_source">show source</a> ]</p>
+  <div id="M000059_source" class="dyn-source">
+<pre>
+<span class="ruby-comment cmt"># File lib/facets/core/hash/rand_value.rb, line 16</span>
+  <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">rand_value</span>
+    <span class="ruby-identifier">fetch</span>( <span class="ruby-identifier">rand_key</span> )
+  <span class="ruby-keyword kw">end</span>
+</pre>
+  </div>
+</div>
+</div>
+<div class="method">
+  <div class="title">
+    <a name="M000060"></a><b>rand_value!</b>()
+  </div>
+  <div class="description">
+  <p>
+Deletes a random key-value pair and returns the value.
+</p>
+<pre>
+  a = {:one =&gt; 1, :two =&gt; 2, :three =&gt; 3}
+  a.at_rand!  #=&gt; 2
+  a           #=&gt; {:one =&gt; 1, :three =&gt; 3}
+</pre>
+  </div>
+<div class="aka">
+  This method is also aliased as
+  <a href="Hash.html#M000061">pick</a>
+  <a href="Hash.html#M000063">at_rand!</a>
+</div>
+<div class="sourcecode">
+  <p class="source-link">[ <a href="javascript:toggleSource('M000060_source')" id="l_M000060_source">show source</a> ]</p>
+  <div id="M000060_source" class="dyn-source">
+<pre>
+<span class="ruby-comment cmt"># File lib/facets/core/hash/rand_value.rb, line 26</span>
+  <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">rand_value!</span>
+    <span class="ruby-identifier">k</span>,<span class="ruby-identifier">v</span> = <span class="ruby-identifier">rand_pair</span>
+    <span class="ruby-identifier">delete</span>( <span class="ruby-identifier">k</span> )
+    <span class="ruby-keyword kw">return</span> <span class="ruby-identifier">v</span>
+  <span class="ruby-keyword kw">end</span>
+</pre>
+  </div>
+</div>
+</div>
+<div class="method">
+  <div class="title">
+    <a name="M000071"></a><b>replace_each</b>( {|| ...}
+  </div>
+  <div class="description">
+  <p>
+Same as <a href="Hash.html#M000098">update_each</a>, but deletes the key
+element first.
+</p>
+  </div>
+<div class="sourcecode">
+  <p class="source-link">[ <a href="javascript:toggleSource('M000071_source')" id="l_M000071_source">show source</a> ]</p>
+  <div id="M000071_source" class="dyn-source">
+<pre>
+<span class="ruby-comment cmt"># File lib/facets/core/hash/replace_each.rb, line 4</span>
+  <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">replace_each</span>  <span class="ruby-comment cmt"># :yield:</span>
+    <span class="ruby-identifier">dup</span>.<span class="ruby-identifier">each_pair</span>{ <span class="ruby-operator">|</span><span class="ruby-identifier">k</span>,<span class="ruby-identifier">v</span><span class="ruby-operator">|</span> <span class="ruby-identifier">delete</span>( <span class="ruby-identifier">k</span> ); <span class="ruby-identifier">update</span>( <span class="ruby-keyword kw">yield</span>(<span class="ruby-identifier">k</span>,<span class="ruby-identifier">v</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="M000081"></a><b>shuffle</b>()
+  </div>
+  <div class="description">
+  <p>
+Returns a copy of the hash with <em>values</em> arranged in new random
+order.
+</p>
+<pre>
+  h = {:a=&gt;1, :b=&gt;2, :c=&gt;3}
+  h.shuffle_hash  #=&gt; {:b=&gt;2, :c=&gt;1, :a&gt;3}
+</pre>
+  </div>
+<div class="sourcecode">
+  <p class="source-link">[ <a href="javascript:toggleSource('M000081_source')" id="l_M000081_source">show source</a> ]</p>
+  <div id="M000081_source" class="dyn-source">
+<pre>
+<span class="ruby-comment cmt"># File lib/facets/core/hash/shuffle.rb, line 11</span>
+  <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">shuffle</span>
+    <span class="ruby-constant">Hash</span>.<span class="ruby-identifier">zipnew</span>( <span class="ruby-identifier">keys</span>.<span class="ruby-identifier">sort_by</span>{<span class="ruby-constant">Kernel</span>.<span class="ruby-identifier">rand</span>}, <span class="ruby-identifier">values</span>.<span class="ruby-identifier">sort_by</span>{<span class="ruby-constant">Kernel</span>.<span class="ruby-identifier">rand</span>} )
+  <span class="ruby-keyword kw">end</span>
+</pre>
+  </div>
+</div>
+</div>
+<div class="method">
+  <div class="title">
+    <a name="M000082"></a><b>shuffle!</b>()
+  </div>
+  <div class="description">
+  <p>
+Destructive shuffle_hash. Arrange the values in a new random order.
+</p>
+<pre>
+  h = {:a =&gt; 1, :b =&gt; 2, :c =&gt; 3}
+  h.shuffle_hash!
+  h  #=&gt; {:b=&gt;2, :c=&gt;1, :a=&gt;3}
+</pre>
+  </div>
+<div class="sourcecode">
+  <p class="source-link">[ <a href="javascript:toggleSource('M000082_source')" id="l_M000082_source">show source</a> ]</p>
+  <div id="M000082_source" class="dyn-source">
+<pre>
+<span class="ruby-comment cmt"># File lib/facets/core/hash/shuffle.rb, line 22</span>
+  <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">shuffle!</span>
+    <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">replace</span>( <span class="ruby-identifier">shuffle</span> )
+  <span class="ruby-keyword kw">end</span>
+</pre>
+  </div>
+</div>
+</div>
+<div class="method">
+  <div class="title">
+    <a name="M000090"></a><b>stringify_keys</b>( from_class=nil )
+  </div>
+  <div class="description">
+  <p>
+Alias for <a href="Hash.html#M000089">keys_to_s</a>
+</p>
+  </div>
+</div>
+<div class="method">
+  <div class="title">
+    <a name="M000092"></a><b>stringify_keys!</b>( from_class=nil )
+  </div>
+  <div class="description">
+  <p>
+Alias for <a href="Hash.html#M000091">keys_to_s!</a>
+</p>
+  </div>
+</div>
+<div class="method">
+  <div class="title">
+    <a name="M000072"></a><b>swap!</b>( key1, key2 )
+  </div>
+  <div class="description">
+  <p>
+Swap the values of a pair of keys in place.
+</p>
+<pre>
+  {:a=&gt;1,:b=&gt;2}.swap!  #=&gt; {:a=&gt;2,:b=&gt;1}
+</pre>
+  </div>
+<div class="sourcecode">
+  <p class="source-link">[ <a href="javascript:toggleSource('M000072_source')" id="l_M000072_source">show source</a> ]</p>
+  <div id="M000072_source" class="dyn-source">
+<pre>
+<span class="ruby-comment cmt"># File lib/facets/core/hash/swap.rb, line 7</span>
+  <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">swap!</span>( <span class="ruby-identifier">key1</span>, <span class="ruby-identifier">key2</span> )
+    <span class="ruby-identifier">tmp</span> = <span class="ruby-keyword kw">self</span>[<span class="ruby-identifier">key1</span>]
+    <span class="ruby-keyword kw">self</span>[<span class="ruby-identifier">key1</span>] = <span class="ruby-keyword kw">self</span>[<span class="ruby-identifier">key2</span>]
+    <span class="ruby-keyword kw">self</span>[<span class="ruby-identifier">key2</span>] = <span class="ruby-identifier">tmp</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="M000088"></a><b>swapkey!</b>( newkey, oldkey )
+  </div>
+  <div class="description">
+  <p>
+Modifies the receiving <a href="Hash.html">Hash</a> so that the value
+previously referred to by <em>oldkey</em> is referenced by <em>newkey</em>;
+<em>oldkey</em> is removed from the <a href="Hash.html">Hash</a>. If
+<em>oldkey</em> does not exist as a key in the <a
+href="Hash.html">Hash</a>, no change is effected.
+</p>
+<p>
+Returns a reference to the <a href="Hash.html">Hash</a>.
+</p>
+<pre>
+  foo = { :a=&gt;1, :b=&gt;2 }
+  foo.swapkey!('a',:a)       #=&gt; { 'a'=&gt;1, :b=&gt;2 }
+  foo.swapkey!('b',:b)       #=&gt; { 'a'=&gt;1, 'b'=&gt;2 }
+  foo.swapkey!('foo','bar')  #=&gt; { 'a'=&gt;1, 'b'=&gt;2 }
+</pre>
+  </div>
+<div class="sourcecode">
+  <p class="source-link">[ <a href="javascript:toggleSource('M000088_source')" id="l_M000088_source">show source</a> ]</p>
+  <div id="M000088_source" class="dyn-source">
+<pre>
+<span class="ruby-comment cmt"># File lib/facets/core/hash/swapkey.rb, line 16</span>
+  <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">swapkey!</span>( <span class="ruby-identifier">newkey</span>, <span class="ruby-identifier">oldkey</span> )
+    <span class="ruby-keyword kw">self</span>[<span class="ruby-identifier">newkey</span>] = <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">delete</span>(<span class="ruby-identifier">oldkey</span>) <span class="ruby-keyword kw">if</span> <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">has_key?</span>(<span class="ruby-identifier">oldkey</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="M000066"></a><b>symbolize_keys</b>( from_class=String )
+  </div>
+  <div class="description">
+  <p>
+Alias for <a href="Hash.html#M000065">keys_to_sym</a>
+</p>
+  </div>
+</div>
+<div class="method">
+  <div class="title">
+    <a name="M000068"></a><b>symbolize_keys!</b>( from_class=String )
+  </div>
+  <div class="description">
+  <p>
+Alias for <a href="Hash.html#M000067">keys_to_sym!</a>
+</p>
+  </div>
+</div>
+<div class="method">
+  <div class="title">
+    <a name="M000076"></a><b>to_h</b>()
+  </div>
+  <div class="description">
+  <p>
+Return a rehashing of <em>self</em>.
+</p>
+<pre>
+  {&quot;a&quot;=&gt;1,&quot;b&quot;=&gt;2}.to_h  #=&gt; {&quot;b&quot;=&gt;2,&quot;a&quot;=&gt;1}
+</pre>
+  </div>
+<div class="sourcecode">
+  <p class="source-link">[ <a href="javascript:toggleSource('M000076_source')" id="l_M000076_source">show source</a> ]</p>
+  <div id="M000076_source" class="dyn-source">
+<pre>
+<span class="ruby-comment cmt"># File lib/facets/core/hash/to_h.rb, line 10</span>
+  <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">to_h</span>; <span class="ruby-identifier">rehash</span>; <span class="ruby-keyword kw">end</span>
+</pre>
+  </div>
+</div>
+</div>
+<div class="method">
+  <div class="title">
+    <a name="M000056"></a><b>to_ostruct</b>()
+  </div>
+  <div class="description">
+  <p>
+Turns a hash into a generic object using an <a
+href="OpenStruct.html">OpenStruct</a>.
+</p>
+<pre>
+  o = { 'a' =&gt; 1 }.to_ostruct
+  o.a  #=&gt; 1
+</pre>
+  </div>
+<div class="sourcecode">
+  <p class="source-link">[ <a href="javascript:toggleSource('M000056_source')" id="l_M000056_source">show source</a> ]</p>
+  <div id="M000056_source" class="dyn-source">
+<pre>
+<span class="ruby-comment cmt"># File lib/facets/core/hash/to_ostruct.rb, line 10</span>
+  <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">to_ostruct</span>
+    <span class="ruby-constant">OpenStruct</span>.<span class="ruby-identifier">new</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="M000087"></a><b>to_ostruct_recurse</b>( exclude={} )
+  </div>
+  <div class="description">
+  <p>
+Like <a href="Hash.html#M000056">to_ostruct</a> but recusively objectifies
+all hash elements as well.
+</p>
+<pre>
+    o = { 'a' =&gt; { 'b' =&gt; 1 } }.to_ostruct_recurse
+    o.a.b  #=&gt; 1
+</pre>
+<p>
+The <tt>exclude</tt> parameter is used internally to prevent infinite
+recursion and is not intended to be utilized by the end-user. But for more
+advance use, if there is a particular subhash you would like to prevent
+from being converted to an OpoenStruct then include it in the
+<tt>exclude</tt> hash referencing itself. Eg.
+</p>
+<pre>
+    h = { 'a' =&gt; { 'b' =&gt; 1 } }
+    o = h.to_ostruct_recurse( { h['a'] =&gt; h['a'] } )
+    o.a['b']  #=&gt; 1
+</pre>
+  </div>
+<div class="sourcecode">
+  <p class="source-link">[ <a href="javascript:toggleSource('M000087_source')" id="l_M000087_source">show source</a> ]</p>
+  <div id="M000087_source" class="dyn-source">
+<pre>
+<span class="ruby-comment cmt"># File lib/facets/core/hash/to_ostruct_recurse.rb, line 26</span>
+  <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">to_ostruct_recurse</span>( <span class="ruby-identifier">exclude</span>={} )
+    <span class="ruby-keyword kw">return</span> <span class="ruby-identifier">exclude</span>[<span class="ruby-keyword kw">self</span>] <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">exclude</span>.<span class="ruby-identifier">key?</span>( <span class="ruby-keyword kw">self</span> )
+    <span class="ruby-identifier">o</span> = <span class="ruby-identifier">exclude</span>[<span class="ruby-keyword kw">self</span>] = <span class="ruby-constant">OpenStruct</span>.<span class="ruby-identifier">new</span>
+    <span class="ruby-identifier">h</span> = <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">dup</span>
+    <span class="ruby-identifier">each_pair</span> <span class="ruby-keyword kw">do</span> <span class="ruby-operator">|</span><span class="ruby-identifier">k</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-identifier">to_ostruct_recurse</span>( <span class="ruby-identifier">exclude</span> ) <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">v</span>.<span class="ruby-identifier">respond_to?</span>( <span class="ruby-identifier">:to_ostruct_recurse</span> )
+    <span class="ruby-keyword kw">end</span>
+    <span class="ruby-identifier">o</span>.<span class="ruby-identifier">__update__</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="M000099"></a><b>to_proc</b>()
+  </div>
+  <div class="description">
+  <p>
+Constructs a <a href="Proc.html">Proc</a> object from a hash such that the
+parameter of the <a href="Proc.html">Proc</a> is assigned the hash keys as
+attributes.
+</p>
+<pre>
+  h = { :a =&gt; 1 }
+  p = h.to_proc
+  o = OpenStruct.new
+  p.call(o)
+  o.a  #=&gt; 1
+</pre>
+  </div>
+<div class="sourcecode">
+  <p class="source-link">[ <a href="javascript:toggleSource('M000099_source')" id="l_M000099_source">show source</a> ]</p>
+  <div id="M000099_source" class="dyn-source">
+<pre>
+<span class="ruby-comment cmt"># File lib/facets/core/hash/to_proc.rb, line 15</span>
+  <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">to_proc</span>
+    <span class="ruby-identifier">lambda</span> <span class="ruby-keyword kw">do</span> <span class="ruby-operator">|</span><span class="ruby-identifier">o</span><span class="ruby-operator">|</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">k</span>,<span class="ruby-identifier">v</span><span class="ruby-operator">|</span>
+        <span class="ruby-identifier">ke</span> = <span class="ruby-node">&quot;#{k}=&quot;</span>
+        <span class="ruby-identifier">o</span>.<span class="ruby-identifier">__send__</span>(<span class="ruby-identifier">ke</span>, <span class="ruby-identifier">v</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="M000100"></a><b>to_proc_with_reponse</b>()
+  </div>
+<div class="sourcecode">
+  <p class="source-link">[ <a href="javascript:toggleSource('M000100_source')" id="l_M000100_source">show source</a> ]</p>
+  <div id="M000100_source" class="dyn-source">
+<pre>
+<span class="ruby-comment cmt"># File lib/facets/core/hash/to_proc.rb, line 24</span>
+  <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">to_proc_with_reponse</span>
+    <span class="ruby-identifier">lambda</span> <span class="ruby-keyword kw">do</span> <span class="ruby-operator">|</span><span class="ruby-identifier">o</span><span class="ruby-operator">|</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">k</span>,<span class="ruby-identifier">v</span><span class="ruby-operator">|</span>
+        <span class="ruby-identifier">ke</span> = <span class="ruby-node">&quot;#{k}=&quot;</span>
+        <span class="ruby-identifier">o</span>.<span class="ruby-identifier">__send__</span>(<span class="ruby-identifier">ke</span>, <span class="ruby-identifier">v</span>) <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">respond_to?</span>(<span class="ruby-identifier">ke</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="M000079"></a><b>traverse</b>(&amp;b)
+  </div>
+  <div class="description">
+  <p>
+Returns a new hash created by traversing the hash and its subhashes,
+executing the given block on the key and value. The block should return a
+2-element array of the form +[key, value]+.
+</p>
+<pre>
+  h = { &quot;A&quot;=&gt;&quot;A&quot;, &quot;B&quot;=&gt;&quot;B&quot; }
+  g = h.traverse { |k,v| [k.downcase, v] }
+  g  #=&gt; { &quot;a&quot;=&gt;&quot;A&quot;, &quot;b&quot;=&gt;&quot;B&quot; }
+</pre>
+  </div>
+<div class="sourcecode">
+  <p class="source-link">[ <a href="javascript:toggleSource('M000079_source')" id="l_M000079_source">show source</a> ]</p>
+  <div id="M000079_source" class="dyn-source">
+<pre>
+<span class="ruby-comment cmt"># File lib/facets/core/hash/traverse.rb, line 16</span>
+  <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">traverse</span>(<span class="ruby-operator">&amp;</span><span class="ruby-identifier">b</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-identifier">k</span>,<span class="ruby-identifier">v</span>)<span class="ruby-operator">|</span>
+      <span class="ruby-identifier">v</span> = ( <span class="ruby-constant">Hash</span> <span class="ruby-operator">===</span> <span class="ruby-identifier">v</span> <span class="ruby-value">? </span><span class="ruby-identifier">v</span>.<span class="ruby-identifier">traverse</span>(<span class="ruby-operator">&amp;</span><span class="ruby-identifier">b</span>) <span class="ruby-operator">:</span> <span class="ruby-identifier">v</span> )
+      <span class="ruby-identifier">nk</span>, <span class="ruby-identifier">nv</span> = <span class="ruby-identifier">b</span>[<span class="ruby-identifier">k</span>,<span class="ruby-identifier">v</span>]
+      <span class="ruby-identifier">h</span>[<span class="ruby-identifier">nk</span>] = <span class="ruby-identifier">nv</span> <span class="ruby-comment cmt">#( Hash === v ? v.traverse(base,&amp;b) : nv )</span>
+      <span class="ruby-identifier">h</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="M000080"></a><b>traverse!</b>(&amp;b)
+  </div>
+  <div class="description">
+  <p>
+In place version of traverse, which traverses the hash and its subhashes,
+executing the given block on the key and value.
+</p>
+<pre>
+  h = { &quot;A&quot;=&gt;&quot;A&quot;, &quot;B&quot;=&gt;&quot;B&quot; }
+  h.traverse! { |k,v| [k.downcase, v] }
+  h  #=&gt; { &quot;a&quot;=&gt;&quot;A&quot;, &quot;b&quot;=&gt;&quot;B&quot; }
+</pre>
+  </div>
+<div class="sourcecode">
+  <p class="source-link">[ <a href="javascript:toggleSource('M000080_source')" id="l_M000080_source">show source</a> ]</p>
+  <div id="M000080_source" class="dyn-source">
+<pre>
+<span class="ruby-comment cmt"># File lib/facets/core/hash/traverse.rb, line 32</span>
+  <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">traverse!</span>(<span class="ruby-operator">&amp;</span><span class="ruby-identifier">b</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">traverse</span>(<span class="ruby-operator">&amp;</span><span class="ruby-identifier">b</span>) )
+  <span class="ruby-keyword kw">end</span>
+</pre>
+  </div>
+</div>
+</div>
+<div class="method">
+  <div class="title">
+    <a name="M000098"></a><b>update_each</b>( {|| ...}
+  </div>
+  <div class="description">
+  <p>
+Iterates through each pair and updates a the hash in place. This is
+formally equivalent to <a href="Hash.html#M000049">collate!</a> But does
+not use <a href="Hash.html#M000048">collate</a> to accomplish the task.
+Hence <a href="Hash.html#M000098">update_each</a> is probably a bit faster.
+</p>
+<pre>
+  # TODO
+</pre>
+  </div>
+<div class="sourcecode">
+  <p class="source-link">[ <a href="javascript:toggleSource('M000098_source')" id="l_M000098_source">show source</a> ]</p>
+  <div id="M000098_source" class="dyn-source">
+<pre>
+<span class="ruby-comment cmt"># File lib/facets/core/hash/update_each.rb, line 14</span>
+  <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">update_each</span>  <span class="ruby-comment cmt"># :yield:</span>
+    <span class="ruby-identifier">dup</span>.<span class="ruby-identifier">each_pair</span>{ <span class="ruby-operator">|</span><span class="ruby-identifier">k</span>,<span class="ruby-identifier">v</span><span class="ruby-operator">|</span> <span class="ruby-identifier">update</span>( <span class="ruby-keyword kw">yield</span>(<span class="ruby-identifier">k</span>,<span class="ruby-identifier">v</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="M000094"></a><b>update_keys</b>() {|k| ...}
+  </div>
+<div class="sourcecode">
+  <p class="source-link">[ <a href="javascript:toggleSource('M000094_source')" id="l_M000094_source">show source</a> ]</p>
+  <div id="M000094_source" class="dyn-source">
+<pre>
+<span class="ruby-comment cmt"># File lib/facets/core/hash/update_keys.rb, line 4</span>
+  <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">update_keys</span>
+    <span class="ruby-identifier">each</span>{ <span class="ruby-operator">|</span><span class="ruby-identifier">k</span>,<span class="ruby-identifier">v</span><span class="ruby-operator">|</span> <span class="ruby-identifier">delete</span>(<span class="ruby-identifier">k</span>) ; <span class="ruby-identifier">store</span>( <span class="ruby-keyword kw">yield</span>(<span class="ruby-identifier">k</span>), <span class="ruby-identifier">v</span> ) }
+  <span class="ruby-keyword kw">end</span>
+</pre>
+  </div>
+</div>
+</div>
+<div class="method">
+  <div class="title">
+    <a name="M000057"></a><b>update_values</b>() {|v| ...}
+  </div>
+<div class="sourcecode">
+  <p class="source-link">[ <a href="javascript:toggleSource('M000057_source')" id="l_M000057_source">show source</a> ]</p>
+  <div id="M000057_source" class="dyn-source">
+<pre>
+<span class="ruby-comment cmt"># File lib/facets/core/hash/update_values.rb, line 4</span>
+  <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">update_values</span>
+    <span class="ruby-identifier">each</span>{ <span class="ruby-operator">|</span><span class="ruby-identifier">k</span>,<span class="ruby-identifier">v</span><span class="ruby-operator">|</span> <span class="ruby-identifier">store</span>( <span class="ruby-identifier">k</span>, <span class="ruby-keyword kw">yield</span>(<span class="ruby-identifier">v</span>) ) }
+  <span class="ruby-keyword kw">end</span>
+</pre>
+  </div>
+</div>
+</div>
+<div class="method">
+  <div class="title">
+    <a name="M000077"></a><b>variablize_keys</b>( of_class=nil )
+  </div>
+  <div class="description">
+  <p>
+Converts all keys in the <a href="Hash.html">Hash</a> to be <a
+href="String.html">String</a> values, returning a new <a
+href="Hash.html">Hash</a>. With a from_class parameter, limits conversion
+to only a certain class of keys. It defaults to nil which convert any key
+class.
+</p>
+<pre>
+  foo = { :name=&gt;'Gavin', :wife=&gt;:Lisa }
+  foo.variablize_keys    #=&gt;  { &quot;@name&quot;=&gt;&quot;Gavin&quot;, &quot;@wife&quot;=&gt;:Lisa }
+  foo.inspect            #=&gt;  { :name =&gt;&quot;Gavin&quot;, :wife=&gt;:Lisa }
+</pre>
+  </div>
+<div class="sourcecode">
+  <p class="source-link">[ <a href="javascript:toggleSource('M000077_source')" id="l_M000077_source">show source</a> ]</p>
+  <div id="M000077_source" class="dyn-source">
+<pre>
+<span class="ruby-comment cmt"># File lib/facets/core/hash/variablize_keys.rb, line 11</span>
+  <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">variablize_keys</span>( <span class="ruby-identifier">of_class</span>=<span class="ruby-keyword kw">nil</span> )
+    <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">dup</span>.<span class="ruby-identifier">variablize_keys!</span>( <span class="ruby-identifier">of_class</span> )
+  <span class="ruby-keyword kw">end</span>
+</pre>
+  </div>
+</div>
+</div>
+<div class="method">
+  <div class="title">
+    <a name="M000078"></a><b>variablize_keys!</b>( of_class=nil )
+  </div>
+  <div class="description">
+  <p>
+Synonym for Hash#keys_to_string, but modifies the receiver in place (and
+returns it). With a from_class parameter, limits conversion to only a
+certain class of keys. It defaults to nil which convert any key class.
+</p>
+<pre>
+  foo = { :name=&gt;'Gavin', :wife=&gt;:Lisa }
+  foo.variablize_keys!   #=&gt;  { &quot;@name&quot;=&gt;&quot;Gavin&quot;, &quot;@wife&quot;=&gt;:Lisa }
+  foo.inspect            #=&gt;  { &quot;@name&quot;=&gt;&quot;Gavin&quot;, &quot;@wife&quot;=&gt;:Lisa }
+</pre>
+  </div>
+<div class="sourcecode">
+  <p class="source-link">[ <a href="javascript:toggleSource('M000078_source')" id="l_M000078_source">show source</a> ]</p>
+  <div id="M000078_source" class="dyn-source">
+<pre>
+<span class="ruby-comment cmt"># File lib/facets/core/hash/variablize_keys.rb, line 23</span>
+  <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">variablize_keys!</span>( <span class="ruby-identifier">of_class</span>=<span class="ruby-keyword kw">nil</span> )
+    <span class="ruby-identifier">raise</span> <span class="ruby-constant">ArgumentError</span>, <span class="ruby-value str">&quot;Parameter must be a class&quot;</span> <span class="ruby-keyword kw">unless</span> <span class="ruby-identifier">of_class</span>.<span class="ruby-identifier">kind_of?</span>(<span class="ruby-constant">Class</span>) <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">of_class</span>
+    <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">of_class</span>
+      <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">each_key</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-keyword kw">if</span> <span class="ruby-identifier">k</span>.<span class="ruby-identifier">respond_to?</span>(<span class="ruby-identifier">:to_s</span>) <span class="ruby-keyword kw">and</span> <span class="ruby-identifier">k</span>.<span class="ruby-identifier">class</span> <span class="ruby-operator">==</span> <span class="ruby-identifier">of_class</span>
+          <span class="ruby-identifier">k</span> = <span class="ruby-identifier">k</span>.<span class="ruby-identifier">to_s</span>
+          <span class="ruby-identifier">nk</span> = <span class="ruby-identifier">k</span>[<span class="ruby-value">0</span>,<span class="ruby-value">1</span>] <span class="ruby-operator">!=</span> <span class="ruby-value str">'@'</span> <span class="ruby-operator">?</span> <span class="ruby-identifier">k</span> <span class="ruby-operator">:</span> <span class="ruby-node">&quot;@#{k}&quot;</span>
+          <span class="ruby-keyword kw">self</span>[<span class="ruby-identifier">nk</span>]=<span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">delete</span>(<span class="ruby-identifier">k</span>)
+        <span class="ruby-keyword kw">end</span>
+      <span class="ruby-keyword kw">end</span>
+    <span class="ruby-keyword kw">else</span>
+      <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">each_key</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-keyword kw">if</span> <span class="ruby-identifier">k</span>.<span class="ruby-identifier">respond_to?</span>(<span class="ruby-identifier">:to_s</span>)
+          <span class="ruby-identifier">k</span> = <span class="ruby-identifier">k</span>.<span class="ruby-identifier">to_s</span>
+          <span class="ruby-identifier">nk</span> = <span class="ruby-identifier">k</span>[<span class="ruby-value">0</span>,<span class="ruby-value">1</span>] <span class="ruby-operator">!=</span> <span class="ruby-value str">'@'</span> <span class="ruby-operator">?</span> <span class="ruby-identifier">k</span> <span class="ruby-operator">:</span> <span class="ruby-node">&quot;@#{k}&quot;</span>
+          <span class="ruby-keyword kw">self</span>[<span class="ruby-identifier">nk</span>]=<span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">delete</span>(<span class="ruby-identifier">k</span>)
+        <span class="ruby-keyword kw">end</span>
+      <span class="ruby-keyword kw">end</span>
+    <span class="ruby-keyword kw">end</span>
+    <span class="ruby-keyword kw">self</span>
+  <span class="ruby-keyword kw">end</span>
+</pre>
+  </div>
+</div>
+</div>
+<div class="method">
+  <div class="title">
+    <a name="M000093"></a><b>weave</b>(h)
+  </div>
+  <div class="description">
+  <p>
+Weaves two hashes producing a new hash. The two hashes need to be
+compatible according to the following rules for each node:
+</p>
+<pre>
+  &lt;tt&gt;
+  hash, hash =&gt; hash (recursive +)
+  hash, array =&gt; error
+  hash, value =&gt; error
+  array, hash =&gt; error
+  array, array =&gt; array + array
+  array, value =&gt; array &lt;&lt; value
+  value, hash =&gt; error
+  value, array =&gt; array.unshift(valueB)
+  valueA, valueB =&gt; valueB
+  &lt;/tt&gt;
+</pre>
+<p>
+Example:
+</p>
+<pre>
+  # to do
+</pre>
+  </div>
+<div class="sourcecode">
+  <p class="source-link">[ <a href="javascript:toggleSource('M000093_source')" id="l_M000093_source">show source</a> ]</p>
+  <div id="M000093_source" class="dyn-source">
+<pre>
+<span class="ruby-comment cmt"># File lib/facets/core/hash/weave.rb, line 23</span>
+  <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">weave</span>(<span class="ruby-identifier">h</span>)
+    <span class="ruby-identifier">raise</span> <span class="ruby-constant">ArgumentError</span>, <span class="ruby-value str">&quot;Hash expected&quot;</span> <span class="ruby-keyword kw">unless</span> <span class="ruby-identifier">h</span>.<span class="ruby-identifier">kind_of?</span>(<span class="ruby-constant">Hash</span>)
+    <span class="ruby-identifier">s</span> = <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">clone</span>
+    <span class="ruby-identifier">h</span>.<span class="ruby-identifier">each</span> { <span class="ruby-operator">|</span><span class="ruby-identifier">k</span>,<span class="ruby-identifier">node</span><span class="ruby-operator">|</span>
+      <span class="ruby-identifier">node_is_hash</span> = <span class="ruby-identifier">node</span>.<span class="ruby-identifier">kind_of?</span>(<span class="ruby-constant">Hash</span>)
+      <span class="ruby-identifier">node_is_array</span> = <span class="ruby-identifier">node</span>.<span class="ruby-identifier">kind_of?</span>(<span class="ruby-constant">Array</span>)
+      <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">s</span>.<span class="ruby-identifier">has_key?</span>(<span class="ruby-identifier">k</span>)
+        <span class="ruby-identifier">self_node_is_hash</span> = <span class="ruby-identifier">s</span>[<span class="ruby-identifier">k</span>].<span class="ruby-identifier">kind_of?</span>(<span class="ruby-constant">Hash</span>)
+        <span class="ruby-identifier">self_node_is_array</span> = <span class="ruby-identifier">s</span>[<span class="ruby-identifier">k</span>].<span class="ruby-identifier">kind_of?</span>(<span class="ruby-constant">Array</span>)
+        <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">self_node_is_hash</span>
+          <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">node_is_hash</span>
+            <span class="ruby-identifier">s</span>[<span class="ruby-identifier">k</span>] = <span class="ruby-identifier">s</span>[<span class="ruby-identifier">k</span>].<span class="ruby-identifier">weave</span>(<span class="ruby-identifier">node</span>)
+          <span class="ruby-keyword kw">elsif</span> <span class="ruby-identifier">node_is_array</span>
+            <span class="ruby-identifier">raise</span> <span class="ruby-constant">ArgumentError</span>, <span class="ruby-value str">'Incompatible hash addition'</span> <span class="ruby-comment cmt">#self[k] = node</span>
+          <span class="ruby-keyword kw">else</span>
+            <span class="ruby-identifier">raise</span> <span class="ruby-constant">ArgumentError</span>, <span class="ruby-value str">'Incompatible hash addition'</span> <span class="ruby-comment cmt">#self[k] = node</span>
+          <span class="ruby-keyword kw">end</span>
+        <span class="ruby-keyword kw">elsif</span> <span class="ruby-identifier">self_node_is_array</span>
+          <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">node_is_hash</span>
+            <span class="ruby-identifier">raise</span> <span class="ruby-constant">ArgumentError</span>, <span class="ruby-value str">'Incompatible hash addition'</span> <span class="ruby-comment cmt">#self[k] = node</span>
+          <span class="ruby-keyword kw">elsif</span> <span class="ruby-identifier">node_is_array</span>
+            <span class="ruby-identifier">s</span>[<span class="ruby-identifier">k</span>] <span class="ruby-operator">+=</span> <span class="ruby-identifier">node</span>
+          <span class="ruby-keyword kw">else</span>
+            <span class="ruby-identifier">s</span>[<span class="ruby-identifier">k</span>] <span class="ruby-operator">&lt;&lt;</span> <span class="ruby-identifier">node</span>
+          <span class="ruby-keyword kw">end</span>
+        <span class="ruby-keyword kw">else</span>
+          <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">node_is_hash</span>
+            <span class="ruby-identifier">raise</span> <span class="ruby-constant">ArgumentError</span>, <span class="ruby-value str">'Incompatible hash addition'</span> <span class="ruby-comment cmt">#self[k] = node</span>
+          <span class="ruby-keyword kw">elsif</span> <span class="ruby-identifier">node_is_array</span>
+            <span class="ruby-identifier">s</span>[<span class="ruby-identifier">k</span>].<span class="ruby-identifier">unshift</span>( <span class="ruby-identifier">node</span> )
+          <span class="ruby-keyword kw">else</span>
+            <span class="ruby-identifier">s</span>[<span class="ruby-identifier">k</span>] = <span class="ruby-identifier">node</span>
+          <span class="ruby-keyword kw">end</span>
+        <span class="ruby-keyword kw">end</span>
+      <span class="ruby-keyword kw">else</span>
+        <span class="ruby-identifier">s</span>[<span class="ruby-identifier">k</span>] = <span class="ruby-identifier">node</span>
+      <span class="ruby-keyword kw">end</span>
+    }
+    <span class="ruby-identifier">s</span>
+  <span class="ruby-keyword kw">end</span>
+</pre>
+  </div>
+</div>
+</div>
+</div>
+  </div>
+    </body>
+</html>