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

facets 1.4.3 → 1.4.4

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

Files changed (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>