facets 1.4.3 → 1.4.4

data/ProjectInfo

@@ -2,7 +2,7 @@
 
 title    : Facets
 name     : facets
-version  : '1.4.3'
+version  : '1.4.4'
 created  : '2004-12-16'
 status   : Beta/Stable
 
@@ -29,7 +29,6 @@ revision:
   type: darcs
   exclude:
     - 'lib/facet'
-    - 'release'
     - 'web/doc/api'
     - 'web/images'
     - 'setup.rb'
@@ -37,25 +36,25 @@ revision:
 # --- TASKS --- #
 
 backup: !!backup
-  dir: ../BACKUP
+  dir: ../../BACKUP
 
 package: !!package
-  distribute: [ gem, tar.gz ]
-  dir: ../RELEASE
+  distribute: [ tar.gz ] #gem
+  dir: ../releases
   exclude:
     - _darcs
     - web/doc/api
 
-roll: !!package
-  distribute: [ tar.bz2 ]
-  dir: ../REL/roll
-  exclude:
-    - 'web/doc/api'
-    - 'lib/facet/'
-  rules: |
-    lib/facets        **/*       lib/facets/$version
-    data/roll/facets  **/*       data/roll/facets/$version
-    lib               facets.rb  lib/facets/$version
+#roll: !!package
+#  distribute: [ tar.bz2 ]
+#  dir: ../REL/roll
+#  exclude:
+#    - 'web/doc/api'
+#    - 'lib/facet/'
+#  rules: |
+#    lib/facets        **/*       lib/facets/$version
+#    data/roll/facets  **/*       data/roll/facets/$version
+#    lib               facets.rb  lib/facets/$version
 
 release: !!release
   host       : rubyforge.org
@@ -63,7 +62,7 @@ release: !!release
   project    : facets
   groupid    : 804
   package    : Facets
-  dir        : ../RELEASE
+  dir        : ../releases
 
 extest: !!extest
   files: 'lib/facets/**/*.rb'
@@ -71,7 +70,7 @@ extest: !!extest
 test: !!test
 
 rdoc-core: !!rdoc
-  dir: web/doc/api/core
+  dir: doc/api/core
   template: jamis
   options: ['--all', '--inline-source']
   include:
@@ -81,7 +80,7 @@ rdoc-core: !!rdoc
     - Reapfile
 
 rdoc-more: !!rdoc
-  dir: web/doc/api/more
+  dir: doc/api/more
   template: jamis
   options: ['--all', '--inline-source']
   include:
@@ -95,7 +94,7 @@ publish: !!publish
   type: web
   username: transami
   project: facets
-  dir: web
+  dir: doc/web
 
 announce: !!announce
   to: transfire@gmail.com #ruby-talk@ruby-lang.org
@@ -113,3 +112,4 @@ announce: !!announce
 
 count: !!count
   include: 'lib/**/*'
+

data/Reapfile

@@ -21,7 +21,7 @@ desc %{Second stage (rdoc-core,rdoc-more,package)}
 task '2stage' => [ :'rdoc-core', :'rdoc-more', :package ]
 
 desc %{Final stage (publish,release)}
-task '3stage' => [ :puplish, :release ]
+task '3stage' => [ :publish, :release ]
 
 #
 # Generate facet/ redirection folder.

data/WARNING

@@ -53,4 +53,3 @@
   nilclass/length.rb
   nilclass/method_missing.rb
 
-#

data/{note/CHANGELOG → doc/ChangeLog}

@@ -1,5 +1,35 @@
 = Facets Change Log
 
+== 1.4.4
+* added nil#status - Allows a messgae to be passed through
+  a failure chain.
+* added module#alias_method_chain - from rails this is clever
+  idiom for module-based method wrapping. A limited
+  solution, but since there's no standard solution as
+  of yet, well support til then.
+* added enumerable#cascade - cascade a list of actions on each
+  element of an enumerable. Better name for this?
+* method missing in htmlbuilder effected by BasicObject fix
+  (use __self__.method instead of __metod__)
+* minor update to functor.rb. Added @self = function.binding.self.
+  Still tweaking for best meta informatin access.
+* change WebAgent to Web
+* Removed hash/keys_to_iv b/c it is a poor name. Since the alternative
+  of #keys_to_instance_variables conveys the wrong idea, decided to just
+  get rid of this. Instead use the hash#variablize_keys which is also
+  Rails compatibile.
+
+===1.4.1-1.4.2
+* Started using Darcs --finally!
+* Transition to Darcs has interupted ChangeLog though :(
+* Mostly minor fixes in prepeartion for official 1.4 release.
+* Adjusted BasicObject slightly, further reducing unhidden methods.
+  Among them __object__, __method__ and #as. Also added method_missing
+  that detects shadow methods and rebinds them to Object. Keep in mind
+  that woun't help you if you override method_missing which is
+  typical for this class.
+* Fixed bug in BasicObject#__self__.
+
 == 1.4.0
 * Added Cookie, HTTP and HTTPAccess of ...'s library.
 * OpenObject's __get__ and __set__ methods have been changed

data/doc/api/core/classes/Array.html

@@ -0,0 +1,1356 @@
+<?xml version="1.0" encoding="iso-8859-1"?>
+<!DOCTYPE html 
+     PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
+     "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+<html>
+  <head>
+    <title>Class: Array</title>
+    <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1" />
+    <link rel="stylesheet" href=".././rdoc-style.css" type="text/css" media="screen" />
+
+    <script language="JavaScript" type="text/javascript">
+    // <![CDATA[
+
+        function toggleSource( id )
+        {
+          var elem
+          var link
+
+          if( document.getElementById )
+          {
+            elem = document.getElementById( id )
+            link = document.getElementById( "l_" + id )
+          }
+          else if ( document.all )
+          {
+            elem = eval( "document.all." + id )
+            link = eval( "document.all.l_" + id )
+          }
+          else
+            return false;
+
+          if( elem.style.display == "block" )
+          {
+            elem.style.display = "none"
+            link.innerHTML = "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 />Array</td>
+  <td align="right">
+    <table cellspacing=0 cellpadding=2>
+      <tr valign="top">
+        <td>In:</td>
+        <td>
+<a href="../files/lib/facets/core/array/pull_rb.html">lib/facets/core/array/pull.rb</a>
+<a href="../files/lib/facets/core/array/each_with_key_rb.html">lib/facets/core/array/each_with_key.rb</a>
+<a href="../files/lib/facets/core/array/merge_rb.html">lib/facets/core/array/merge.rb</a>
+<a href="../files/lib/facets/core/array/select_rb.html">lib/facets/core/array/select.rb</a>
+<a href="../files/lib/facets/core/array/rand_index_rb.html">lib/facets/core/array/rand_index.rb</a>
+<a href="../files/lib/facets/core/array/rand_subset_rb.html">lib/facets/core/array/rand_subset.rb</a>
+<a href="../files/lib/facets/core/array/unzip_rb.html">lib/facets/core/array/unzip.rb</a>
+<a href="../files/lib/facets/core/array/delete_unless_rb.html">lib/facets/core/array/delete_unless.rb</a>
+<a href="../files/lib/facets/core/array/delete_values_rb.html">lib/facets/core/array/delete_values.rb</a>
+<a href="../files/lib/facets/core/array/last_index_rb.html">lib/facets/core/array/last_index.rb</a>
+<a href="../files/lib/facets/core/array/thru_rb.html">lib/facets/core/array/thru.rb</a>
+<a href="../files/lib/facets/core/array/at_rand_rb.html">lib/facets/core/array/at_rand.rb</a>
+<a href="../files/lib/facets/core/array/first_rb.html">lib/facets/core/array/first.rb</a>
+<a href="../files/lib/facets/core/array/range_rb.html">lib/facets/core/array/range.rb</a>
+<a href="../files/lib/facets/core/array/to_b_rb.html">lib/facets/core/array/to_b.rb</a>
+<a href="../files/lib/facets/core/array/to_h_rb.html">lib/facets/core/array/to_h.rb</a>
+<a href="../files/lib/facets/core/array/mid_rb.html">lib/facets/core/array/mid.rb</a>
+<a href="../files/lib/facets/core/array/delete_values_at_rb.html">lib/facets/core/array/delete_values_at.rb</a>
+<a href="../files/lib/facets/core/array/head_rb.html">lib/facets/core/array/head.rb</a>
+<a href="../files/lib/facets/core/array/pos_rb.html">lib/facets/core/array/pos.rb</a>
+<a href="../files/lib/facets/core/array/rotate_rb.html">lib/facets/core/array/rotate.rb</a>
+<a href="../files/lib/facets/core/array/shuffle_rb.html">lib/facets/core/array/shuffle.rb</a>
+<a href="../files/lib/facets/core/array/op_store_rb.html">lib/facets/core/array/op_store.rb</a>
+<a href="../files/lib/facets/core/array/op_fetch_rb.html">lib/facets/core/array/op_fetch.rb</a>
+<a href="../files/lib/facets/core/array/middle_rb.html">lib/facets/core/array/middle.rb</a>
+<a href="../files/lib/facets/core/array/pick_rb.html">lib/facets/core/array/pick.rb</a>
+<a href="../files/lib/facets/core/array/to_hash_rb.html">lib/facets/core/array/to_hash.rb</a>
+<a href="../files/lib/facets/core/array/store_rb.html">lib/facets/core/array/store.rb</a>
+<a href="../files/lib/facets/core/array/op_mod_rb.html">lib/facets/core/array/op_mod.rb</a>
+<a href="../files/lib/facets/core/array/join_sentence_rb.html">lib/facets/core/array/join_sentence.rb</a>
+<a href="../files/lib/facets/core/array/pot_rb.html">lib/facets/core/array/pot.rb</a>
+<a href="../files/lib/facets/core/enumerable/each_unique_pair_rb.html">lib/facets/core/enumerable/each_unique_pair.rb</a>
+<a href="../files/lib/facets/core/enumerable/every_rb.html">lib/facets/core/enumerable/every.rb</a>
+<a href="../files/lib/facets/core/enumerable/each_combination_rb.html">lib/facets/core/enumerable/each_combination.rb</a>
+<a href="../files/lib/facets/core/enumerable/each_slice_rb.html">lib/facets/core/enumerable/each_slice.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="#M000136">/</a></li>
+  <li><a href="#M000130">[]</a></li>
+  <li><a href="#M000129">[]=</a></li>
+  <li><a href="#M000111">at_rand</a></li>
+  <li><a href="#M000112">at_rand!</a></li>
+  <li><a href="#M000123">body</a></li>
+  <li><a href="#M000107">delete_unless</a></li>
+  <li><a href="#M000108">delete_values</a></li>
+  <li><a href="#M000119">delete_values_at</a></li>
+  <li><a href="#M000142">each_by</a></li>
+  <li><a href="#M000140">each_combination</a></li>
+  <li><a href="#M000141">each_slice</a></li>
+  <li><a href="#M000138">each_unique_pair</a></li>
+  <li><a href="#M000139">every!</a></li>
+  <li><a href="#M000113">first=</a></li>
+  <li><a href="#M000122">foot</a></li>
+  <li><a href="#M000120">head</a></li>
+  <li><a href="#M000137">join_sentence</a></li>
+  <li><a href="#M000114">last=</a></li>
+  <li><a href="#M000109">last_index</a></li>
+  <li><a href="#M000102">merge!</a></li>
+  <li><a href="#M000118">mid</a></li>
+  <li><a href="#M000131">middle</a></li>
+  <li><a href="#M000132">pick</a></li>
+  <li><a href="#M000133">pick!</a></li>
+  <li><a href="#M000124">pos</a></li>
+  <li><a href="#M000104">rand_index</a></li>
+  <li><a href="#M000105">rand_subset</a></li>
+  <li><a href="#M000115">range</a></li>
+  <li><a href="#M000125">rotate</a></li>
+  <li><a href="#M000126">rotate!</a></li>
+  <li><a href="#M000103">select!</a></li>
+  <li><a href="#M000127">shuffle</a></li>
+  <li><a href="#M000128">shuffle!</a></li>
+  <li><a href="#M000135">store</a></li>
+  <li><a href="#M000121">tail</a></li>
+  <li><a href="#M000110">thru</a></li>
+  <li><a href="#M000116">to_b</a></li>
+  <li><a href="#M000117">to_h</a></li>
+  <li><a href="#M000134">to_hash</a></li>
+  <li><a href="#M000106">unzip</a></li>
+  </ul>
+
+
+
+
+
+
+<div class="sectiontitle">Public Instance methods</div>
+<div class="method">
+  <div class="title">
+    <a name="M000136"></a><b>/</b>(len)
+  </div>
+  <div class="description">
+  <p>
+Partition an array into parts of given length.
+</p>
+  </div>
+<div class="sourcecode">
+  <p class="source-link">[ <a href="javascript:toggleSource('M000136_source')" id="l_M000136_source">show source</a> ]</p>
+  <div id="M000136_source" class="dyn-source">
+<pre>
+<span class="ruby-comment cmt"># File lib/facets/core/array/op_mod.rb, line 8</span>
+  <span class="ruby-keyword kw">def</span> <span class="ruby-operator">/</span> <span class="ruby-identifier">len</span>
+    <span class="ruby-identifier">inject</span>([]) <span class="ruby-keyword kw">do</span> <span class="ruby-operator">|</span><span class="ruby-identifier">ary</span>, <span class="ruby-identifier">x</span><span class="ruby-operator">|</span>
+      <span class="ruby-identifier">ary</span> <span class="ruby-operator">&lt;&lt;</span> [] <span class="ruby-keyword kw">if</span> [<span class="ruby-operator">*</span><span class="ruby-identifier">ary</span>.<span class="ruby-identifier">last</span>].<span class="ruby-identifier">nitems</span> <span class="ruby-operator">%</span> <span class="ruby-identifier">len</span> <span class="ruby-operator">==</span> <span class="ruby-value">0</span>
+      <span class="ruby-identifier">ary</span>.<span class="ruby-identifier">last</span> <span class="ruby-operator">&lt;&lt;</span> <span class="ruby-identifier">x</span>
+      <span class="ruby-identifier">ary</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="M000130"></a><b>[]</b>(*args)
+  </div>
+  <div class="description">
+  <p>
+Modifies #[] to also accept an array of indexes.
+</p>
+<pre>
+  a = ['a','b','c','d','e','f']
+
+  a[[1]]      #=&gt; ['b']
+  a[[1,1]]    #=&gt; ['b','b']
+  a[[1,-1]]   #=&gt; ['b','f']
+  a[[0,2,4]]  #=&gt; ['a','c','e']
+</pre>
+  </div>
+<div class="sourcecode">
+  <p class="source-link">[ <a href="javascript:toggleSource('M000130_source')" id="l_M000130_source">show source</a> ]</p>
+  <div id="M000130_source" class="dyn-source">
+<pre>
+<span class="ruby-comment cmt"># File lib/facets/core/array/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">args</span>)
+    <span class="ruby-keyword kw">return</span> <span class="ruby-identifier">values_at</span>(<span class="ruby-operator">*</span><span class="ruby-identifier">args</span>.<span class="ruby-identifier">at</span>(<span class="ruby-value">0</span>)) <span class="ruby-keyword kw">if</span> <span class="ruby-constant">Array</span> <span class="ruby-operator">===</span> <span class="ruby-identifier">args</span>.<span class="ruby-identifier">at</span>(<span class="ruby-value">0</span>)
+    <span class="ruby-keyword kw">return</span> <span class="ruby-identifier">slice</span>(<span class="ruby-operator">*</span><span class="ruby-identifier">args</span>)
+  <span class="ruby-keyword kw">end</span>
+</pre>
+  </div>
+</div>
+</div>
+<div class="method">
+  <div class="title">
+    <a name="M000129"></a><b>[]=</b>(*args)
+  </div>
+  <div class="description">
+  <p>
+Modifies #[]= to accept an array of indexes for assignment.
+</p>
+<pre>
+  a = ['a','b','c','d']
+
+  a[[1,-1]] = ['m','n']    #=&gt; ['m','n']
+  a                        #=&gt; ['a','m','c','n']
+</pre>
+  </div>
+<div class="aka">
+  This method is also aliased as
+  <a href="Array.html#M000135">store</a>
+</div>
+<div class="sourcecode">
+  <p class="source-link">[ <a href="javascript:toggleSource('M000129_source')" id="l_M000129_source">show source</a> ]</p>
+  <div id="M000129_source" class="dyn-source">
+<pre>
+<span class="ruby-comment cmt"># File lib/facets/core/array/op_store.rb, line 12</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-constant">Array</span> <span class="ruby-operator">===</span> <span class="ruby-identifier">args</span>.<span class="ruby-identifier">at</span>(<span class="ruby-value">0</span>)
+      <span class="ruby-identifier">idx</span>,<span class="ruby-identifier">vals</span> = <span class="ruby-identifier">args</span>.<span class="ruby-identifier">at</span>(<span class="ruby-value">0</span>),<span class="ruby-identifier">args</span>.<span class="ruby-identifier">at</span>(<span class="ruby-value">1</span>)
+      <span class="ruby-identifier">idx</span>.<span class="ruby-identifier">each_with_index</span>{ <span class="ruby-operator">|</span><span class="ruby-identifier">a</span>,<span class="ruby-identifier">i</span><span class="ruby-operator">|</span> <span class="ruby-identifier">store</span>(<span class="ruby-identifier">a</span>,<span class="ruby-identifier">vals</span>.<span class="ruby-identifier">at</span>(<span class="ruby-identifier">i</span>)) }
+      <span class="ruby-keyword kw">return</span> <span class="ruby-identifier">values_at</span>( <span class="ruby-operator">*</span><span class="ruby-identifier">idx</span> )
+    <span class="ruby-keyword kw">else</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-keyword kw">end</span>
+</pre>
+  </div>
+</div>
+</div>
+<div class="method">
+  <div class="title">
+    <a name="M000111"></a><b>at_rand</b>()
+  </div>
+  <div class="description">
+  <p>
+Return a random element of the array.
+</p>
+<pre>
+  [1, 2, 3, 4].at_rand           #=&gt; 2
+  [1, 2, 3, 4].at_rand           #=&gt; 4
+</pre>
+  </div>
+<div class="sourcecode">
+  <p class="source-link">[ <a href="javascript:toggleSource('M000111_source')" id="l_M000111_source">show source</a> ]</p>
+  <div id="M000111_source" class="dyn-source">
+<pre>
+<span class="ruby-comment cmt"># File lib/facets/core/array/at_rand.rb, line 8</span>
+  <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">at_rand</span>
+    <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">at</span>( <span class="ruby-identifier">rand</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="M000112"></a><b>at_rand!</b>()
+  </div>
+  <div class="description">
+  <p>
+Same as <a href="Array.html#M000111">at_rand</a>, but acts in place
+removing a random element from the array.
+</p>
+<pre>
+  a = [1,2,3,4]
+  a.at_rand!       #=&gt; 2
+  a                #=&gt; [1,3,4]
+</pre>
+  </div>
+<div class="sourcecode">
+  <p class="source-link">[ <a href="javascript:toggleSource('M000112_source')" id="l_M000112_source">show source</a> ]</p>
+  <div id="M000112_source" class="dyn-source">
+<pre>
+<span class="ruby-comment cmt"># File lib/facets/core/array/at_rand.rb, line 19</span>
+  <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">at_rand!</span>
+    <span class="ruby-keyword kw">return</span> <span class="ruby-identifier">delete_at</span>( <span class="ruby-constant">Kernel</span>.<span class="ruby-identifier">rand</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="M000123"></a><b>body</b>()
+  </div>
+  <div class="description">
+  <p>
+Returns an array of the first element upto, but not including, the last
+element.
+</p>
+<pre>
+  [1,2,3].body  #=&gt; [1,2]
+</pre>
+  </div>
+<div class="sourcecode">
+  <p class="source-link">[ <a href="javascript:toggleSource('M000123_source')" id="l_M000123_source">show source</a> ]</p>
+  <div id="M000123_source" class="dyn-source">
+<pre>
+<span class="ruby-comment cmt"># File lib/facets/core/array/head.rb, line 38</span>
+  <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">body</span>
+    <span class="ruby-identifier">slice</span>(<span class="ruby-value">0</span>,<span class="ruby-identifier">length</span><span class="ruby-operator">-</span><span class="ruby-value">1</span>)
+  <span class="ruby-keyword kw">end</span>
+</pre>
+  </div>
+</div>
+</div>
+<div class="method">
+  <div class="title">
+    <a name="M000107"></a><b>delete_unless</b>(&amp;block)
+  </div>
+<div class="sourcecode">
+  <p class="source-link">[ <a href="javascript:toggleSource('M000107_source')" id="l_M000107_source">show source</a> ]</p>
+  <div id="M000107_source" class="dyn-source">
+<pre>
+<span class="ruby-comment cmt"># File lib/facets/core/array/delete_unless.rb, line 7</span>
+  <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">delete_unless</span> (<span class="ruby-operator">&amp;</span><span class="ruby-identifier">block</span>)
+    <span class="ruby-identifier">delete_if</span> { <span class="ruby-operator">|</span><span class="ruby-identifier">element</span><span class="ruby-operator">|</span> <span class="ruby-keyword kw">not</span> <span class="ruby-identifier">block</span>.<span class="ruby-identifier">call</span>(<span class="ruby-identifier">element</span>) }
+  <span class="ruby-keyword kw">end</span>
+</pre>
+  </div>
+</div>
+</div>
+<div class="method">
+  <div class="title">
+    <a name="M000108"></a><b>delete_values</b>(*values)
+  </div>
+  <div class="description">
+  <p>
+Delete multiple values from array.
+</p>
+<pre>
+  a = [1,2,3,4]
+  a.delete_values(1,2)   #=&gt; [1,2]
+  a                      #=&gt; [3,4]
+</pre>
+  </div>
+<div class="sourcecode">
+  <p class="source-link">[ <a href="javascript:toggleSource('M000108_source')" id="l_M000108_source">show source</a> ]</p>
+  <div id="M000108_source" class="dyn-source">
+<pre>
+<span class="ruby-comment cmt"># File lib/facets/core/array/delete_values.rb, line 9</span>
+  <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">delete_values</span>(<span class="ruby-operator">*</span><span class="ruby-identifier">values</span>)
+    <span class="ruby-identifier">d</span> = []
+    <span class="ruby-identifier">values</span>.<span class="ruby-identifier">each</span>{ <span class="ruby-operator">|</span><span class="ruby-identifier">v</span><span class="ruby-operator">|</span> <span class="ruby-identifier">d</span> <span class="ruby-operator">&lt;&lt;</span> <span class="ruby-identifier">delete</span>(<span class="ruby-identifier">v</span>) }
+    <span class="ruby-identifier">d</span>
+  <span class="ruby-keyword kw">end</span>
+</pre>
+  </div>
+</div>
+</div>
+<div class="method">
+  <div class="title">
+    <a name="M000119"></a><b>delete_values_at</b>(*selectors)
+  </div>
+  <div class="description">
+  <p>
+Delete multiple values from array given indexes or index range.
+</p>
+<pre>
+  a = [1,2,3,4]
+  a.delete_values_at(1,2)   #=&gt; [2,3]
+  a                         #=&gt; [1,4]
+  a = [1,2,3,4]
+  a.delete_values_at(0..2)  #=&gt; [1,2,3]
+  a                         #=&gt; [4]
+</pre>
+  </div>
+<div class="sourcecode">
+  <p class="source-link">[ <a href="javascript:toggleSource('M000119_source')" id="l_M000119_source">show source</a> ]</p>
+  <div id="M000119_source" class="dyn-source">
+<pre>
+<span class="ruby-comment cmt"># File lib/facets/core/array/delete_values_at.rb, line 14</span>
+  <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">delete_values_at</span>(<span class="ruby-operator">*</span><span class="ruby-identifier">selectors</span>)
+    <span class="ruby-identifier">idx</span> = []
+    <span class="ruby-identifier">selectors</span>.<span class="ruby-identifier">each</span>{ <span class="ruby-operator">|</span><span class="ruby-identifier">i</span><span class="ruby-operator">|</span>
+      <span class="ruby-keyword kw">case</span> <span class="ruby-identifier">i</span>
+      <span class="ruby-keyword kw">when</span> <span class="ruby-constant">Range</span>
+        <span class="ruby-identifier">idx</span>.<span class="ruby-identifier">concat</span>( <span class="ruby-identifier">i</span>.<span class="ruby-identifier">to_a</span> )
+      <span class="ruby-keyword kw">else</span>
+        <span class="ruby-identifier">idx</span> <span class="ruby-operator">&lt;&lt;</span> <span class="ruby-identifier">i</span>.<span class="ruby-identifier">to_i</span>
+      <span class="ruby-keyword kw">end</span>
+    }
+    <span class="ruby-identifier">idx</span>.<span class="ruby-identifier">uniq!</span>
+    <span class="ruby-identifier">dvals</span> = <span class="ruby-identifier">values_at</span>(<span class="ruby-operator">*</span><span class="ruby-identifier">idx</span>)
+    <span class="ruby-identifier">idx</span> = (<span class="ruby-value">0</span><span class="ruby-operator">...</span><span class="ruby-identifier">size</span>).<span class="ruby-identifier">to_a</span> <span class="ruby-operator">-</span> <span class="ruby-identifier">idx</span>
+    <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">replace</span>( <span class="ruby-identifier">values_at</span>(<span class="ruby-operator">*</span><span class="ruby-identifier">idx</span>) )
+    <span class="ruby-keyword kw">return</span> <span class="ruby-identifier">dvals</span>
+  <span class="ruby-keyword kw">end</span>
+</pre>
+  </div>
+</div>
+</div>
+<div class="method">
+  <div class="title">
+    <a name="M000142"></a><b>each_by</b>(n=nil, &amp;yld)
+  </div>
+  <div class="description">
+  <p>
+Alias for <a href="Array.html#M000141">each_slice</a>
+</p>
+  </div>
+</div>
+<div class="method">
+  <div class="title">
+    <a name="M000140"></a><b>each_combination</b>(k=2) {|s.values_at(*idx)| ...}
+  </div>
+  <div class="description">
+  <p>
+Yields the block to each unique combination of <em>n</em> elements.
+</p>
+<pre>
+  a = %w|a b c d|
+  a.each_combination(3) do |c|
+    p c
+  end
+</pre>
+<p>
+produces
+</p>
+<pre>
+  [&quot;a&quot;, &quot;b&quot;, &quot;c&quot;]
+  [&quot;a&quot;, &quot;b&quot;, &quot;d&quot;]
+  [&quot;a&quot;, &quot;c&quot;, &quot;d&quot;]
+  [&quot;b&quot;, &quot;c&quot;, &quot;d&quot;]
+</pre>
+  </div>
+<div class="sourcecode">
+  <p class="source-link">[ <a href="javascript:toggleSource('M000140_source')" id="l_M000140_source">show source</a> ]</p>
+  <div id="M000140_source" class="dyn-source">
+<pre>
+<span class="ruby-comment cmt"># File lib/facets/core/enumerable/each_combination.rb, line 18</span>
+  <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">each_combination</span>(<span class="ruby-identifier">k</span>=<span class="ruby-value">2</span>)
+    <span class="ruby-identifier">s</span> = <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">to_a</span>
+    <span class="ruby-identifier">n</span> = <span class="ruby-identifier">s</span>.<span class="ruby-identifier">size</span>
+    <span class="ruby-keyword kw">return</span> <span class="ruby-keyword kw">unless</span> (<span class="ruby-value">1</span><span class="ruby-operator">..</span><span class="ruby-identifier">n</span>) <span class="ruby-operator">===</span> <span class="ruby-identifier">k</span>
+    <span class="ruby-identifier">idx</span> = (<span class="ruby-value">0</span><span class="ruby-operator">...</span><span class="ruby-identifier">k</span>).<span class="ruby-identifier">to_a</span>
+    <span class="ruby-identifier">loop</span> <span class="ruby-keyword kw">do</span>
+      <span class="ruby-keyword kw">yield</span> <span class="ruby-identifier">s</span>.<span class="ruby-identifier">values_at</span>(<span class="ruby-operator">*</span><span class="ruby-identifier">idx</span>)
+      <span class="ruby-identifier">i</span> = <span class="ruby-identifier">k</span> <span class="ruby-operator">-</span> <span class="ruby-value">1</span>
+      <span class="ruby-identifier">i</span> <span class="ruby-operator">-=</span> <span class="ruby-value">1</span> <span class="ruby-keyword kw">while</span> <span class="ruby-identifier">idx</span>[<span class="ruby-identifier">i</span>] <span class="ruby-operator">==</span> <span class="ruby-identifier">n</span> <span class="ruby-operator">-</span> <span class="ruby-identifier">k</span> <span class="ruby-operator">+</span> <span class="ruby-identifier">i</span>
+      <span class="ruby-keyword kw">break</span> <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">i</span> <span class="ruby-operator">&lt;</span> <span class="ruby-value">0</span>
+      <span class="ruby-identifier">idx</span>[<span class="ruby-identifier">i</span>] <span class="ruby-operator">+=</span> <span class="ruby-value">1</span>
+      (<span class="ruby-identifier">i</span> <span class="ruby-operator">+</span> <span class="ruby-value">1</span> <span class="ruby-operator">...</span> <span class="ruby-identifier">k</span>).<span class="ruby-identifier">each</span> {<span class="ruby-operator">|</span><span class="ruby-identifier">j</span><span class="ruby-operator">|</span> <span class="ruby-identifier">idx</span>[<span class="ruby-identifier">j</span>] = <span class="ruby-identifier">idx</span>[<span class="ruby-identifier">i</span>] <span class="ruby-operator">+</span> <span class="ruby-identifier">j</span> <span class="ruby-operator">-</span> <span class="ruby-identifier">i</span>}
+    <span class="ruby-keyword kw">end</span>
+  <span class="ruby-keyword kw">end</span>
+</pre>
+  </div>
+</div>
+</div>
+<div class="method">
+  <div class="title">
+    <a name="M000141"></a><b>each_slice</b>(n=nil, &amp;yld)
+  </div>
+  <div class="description">
+  <p>
+Iterates over <tt>n</tt> elements at a time. If <tt>n</tt> is not given
+then the arity of the block determines the slicing quantity.
+</p>
+<pre>
+  [1, 2, 3, 4].each_slice(2){ |a,b| ... }
+</pre>
+<p>
+This is a specialized version <a
+href="Enumerable.html#M000497">Enumerable#each_slice</a> but optimized
+specifically for <a href="Array.html">Array</a>.
+</p>
+  </div>
+<div class="aka">
+  This method is also aliased as
+  <a href="Array.html#M000142">each_by</a>
+</div>
+<div class="sourcecode">
+  <p class="source-link">[ <a href="javascript:toggleSource('M000141_source')" id="l_M000141_source">show source</a> ]</p>
+  <div id="M000141_source" class="dyn-source">
+<pre>
+<span class="ruby-comment cmt"># File lib/facets/core/enumerable/each_slice.rb, line 50</span>
+  <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">each_slice</span>(<span class="ruby-identifier">n</span>=<span class="ruby-keyword kw">nil</span>, <span class="ruby-operator">&amp;</span><span class="ruby-identifier">yld</span>)
+    <span class="ruby-identifier">n</span> = <span class="ruby-identifier">yld</span>.<span class="ruby-identifier">arity</span>.<span class="ruby-identifier">abs</span> <span class="ruby-keyword kw">unless</span> <span class="ruby-identifier">n</span>
+    <span class="ruby-identifier">i</span>=<span class="ruby-value">0</span>
+    <span class="ruby-keyword kw">while</span> <span class="ruby-identifier">i</span> <span class="ruby-operator">&lt;</span> <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">length</span>
+      <span class="ruby-identifier">yld</span>.<span class="ruby-identifier">call</span>(<span class="ruby-operator">*</span><span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">slice</span>(<span class="ruby-identifier">i</span>,<span class="ruby-identifier">n</span>))
+      <span class="ruby-identifier">i</span><span class="ruby-operator">+=</span><span class="ruby-identifier">n</span>
+    <span class="ruby-keyword kw">end</span>
+  <span class="ruby-keyword kw">end</span>
+</pre>
+  </div>
+</div>
+</div>
+<div class="method">
+  <div class="title">
+    <a name="M000138"></a><b>each_unique_pair</b>(&amp;yld)
+  </div>
+  <div class="description">
+  <p>
+Processes each unique pair (of indices, not value) in the array by yielding
+them to the supplied block.
+</p>
+<pre>
+  a = [1,2,3,4]
+  a.each_unique_pair{ |a,b| puts a+','+b }
+</pre>
+<p>
+produces
+</p>
+<pre>
+  1,2
+  1,3
+  1,4
+  2,3
+  2,4
+  3,4
+</pre>
+<p>
+This does not guarantee the uniqueness of values. For example:
+</p>
+<pre>
+  a = [1,2,1]
+  a.each_unique_pair{ |a,b| puts a+','+b }
+</pre>
+<p>
+prduces
+</p>
+<pre>
+  1,2
+  1,1
+  2,1
+</pre>
+<p>
+This is equivalent to <tt><a
+href="Array.html#M000140">each_combination</a>(2){ &#8230; }</tt>.
+</p>
+  </div>
+<div class="sourcecode">
+  <p class="source-link">[ <a href="javascript:toggleSource('M000138_source')" id="l_M000138_source">show source</a> ]</p>
+  <div id="M000138_source" class="dyn-source">
+<pre>
+<span class="ruby-comment cmt"># File lib/facets/core/enumerable/each_unique_pair.rb, line 33</span>
+  <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">each_unique_pair</span>(<span class="ruby-operator">&amp;</span><span class="ruby-identifier">yld</span>)
+    <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">each_combination</span>(<span class="ruby-value">2</span>,<span class="ruby-operator">&amp;</span><span class="ruby-identifier">yld</span>)
+    <span class="ruby-comment cmt">#s = self.to_a</span>
+    <span class="ruby-comment cmt">#self.each_with_index{ |a,i|</span>
+    <span class="ruby-comment cmt">#  self[(i+1)..-1].each{ |b| yield a,b }</span>
+    <span class="ruby-comment cmt">#}</span>
+  <span class="ruby-keyword kw">end</span>
+</pre>
+  </div>
+</div>
+</div>
+<div class="method">
+  <div class="title">
+    <a name="M000139"></a><b>every!</b>()
+  </div>
+  <div class="description">
+  <p>
+In place version of every.
+</p>
+  </div>
+<div class="sourcecode">
+  <p class="source-link">[ <a href="javascript:toggleSource('M000139_source')" id="l_M000139_source">show source</a> ]</p>
+  <div id="M000139_source" class="dyn-source">
+<pre>
+<span class="ruby-comment cmt"># File lib/facets/core/enumerable/every.rb, line 25</span>
+  <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">every!</span>
+    <span class="ruby-constant">Functor</span>.<span class="ruby-identifier">new</span> <span class="ruby-keyword kw">do</span> <span class="ruby-operator">|</span><span class="ruby-identifier">op</span>,<span class="ruby-operator">*</span><span class="ruby-identifier">args</span><span class="ruby-operator">|</span>
+      <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">replace</span>( <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">collect</span>{ <span class="ruby-operator">|</span><span class="ruby-identifier">a</span><span class="ruby-operator">|</span> <span class="ruby-identifier">a</span>.<span class="ruby-identifier">send</span>(<span class="ruby-identifier">op</span>,<span class="ruby-operator">*</span><span class="ruby-identifier">args</span>) } )
+    <span class="ruby-keyword kw">end</span>
+  <span class="ruby-keyword kw">end</span>
+</pre>
+  </div>
+</div>
+</div>
+<div class="method">
+  <div class="title">
+    <a name="M000113"></a><b>first=</b>(x)
+  </div>
+  <div class="description">
+  <p>
+Change the first element.
+</p>
+<pre>
+  a = [&quot;a&quot;,&quot;y&quot;,&quot;z&quot;]
+  a.first = &quot;x&quot;
+  p a           #=&gt; [&quot;x&quot;,&quot;y&quot;,&quot;z&quot;]
+</pre>
+  </div>
+<div class="sourcecode">
+  <p class="source-link">[ <a href="javascript:toggleSource('M000113_source')" id="l_M000113_source">show source</a> ]</p>
+  <div id="M000113_source" class="dyn-source">
+<pre>
+<span class="ruby-comment cmt"># File lib/facets/core/array/first.rb, line 11</span>
+  <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">first=</span>(<span class="ruby-identifier">x</span>)
+    <span class="ruby-keyword kw">self</span>[<span class="ruby-value">0</span>] = <span class="ruby-identifier">x</span>
+  <span class="ruby-keyword kw">end</span>
+</pre>
+  </div>
+</div>
+</div>
+<div class="method">
+  <div class="title">
+    <a name="M000122"></a><b>foot</b>()
+  </div>
+  <div class="description">
+  <p>
+Like last, returning the last element in an array.
+</p>
+<pre>
+  [1,2,3].foot  #=&gt; [3]
+</pre>
+  </div>
+<div class="sourcecode">
+  <p class="source-link">[ <a href="javascript:toggleSource('M000122_source')" id="l_M000122_source">show source</a> ]</p>
+  <div id="M000122_source" class="dyn-source">
+<pre>
+<span class="ruby-comment cmt"># File lib/facets/core/array/head.rb, line 26</span>
+  <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">foot</span>
+    <span class="ruby-identifier">slice</span>(<span class="ruby-value">-1</span>,<span class="ruby-value">1</span>)
+  <span class="ruby-keyword kw">end</span>
+</pre>
+  </div>
+</div>
+</div>
+<div class="method">
+  <div class="title">
+    <a name="M000120"></a><b>head</b>()
+  </div>
+  <div class="description">
+  <p>
+Like first but returns the first element in a new array.
+</p>
+<pre>
+  [1,2,3].head  #=&gt; [1]
+</pre>
+  </div>
+<div class="sourcecode">
+  <p class="source-link">[ <a href="javascript:toggleSource('M000120_source')" id="l_M000120_source">show source</a> ]</p>
+  <div id="M000120_source" class="dyn-source">
+<pre>
+<span class="ruby-comment cmt"># File lib/facets/core/array/head.rb, line 9</span>
+  <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">head</span>
+    <span class="ruby-identifier">slice</span>(<span class="ruby-value">0</span>,<span class="ruby-value">1</span>)
+  <span class="ruby-keyword kw">end</span>
+</pre>
+  </div>
+</div>
+</div>
+<div class="method">
+  <div class="title">
+    <a name="M000137"></a><b>join_sentence</b>()
+  </div>
+<div class="sourcecode">
+  <p class="source-link">[ <a href="javascript:toggleSource('M000137_source')" id="l_M000137_source">show source</a> ]</p>
+  <div id="M000137_source" class="dyn-source">
+<pre>
+<span class="ruby-comment cmt"># File lib/facets/core/array/join_sentence.rb, line 4</span>
+  <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">join_sentence</span>
+    <span class="ruby-keyword kw">case</span> <span class="ruby-identifier">length</span>
+    <span class="ruby-keyword kw">when</span> <span class="ruby-value">0</span><span class="ruby-operator">:</span> <span class="ruby-value str">&quot;&quot;</span>
+    <span class="ruby-keyword kw">when</span> <span class="ruby-value">1</span><span class="ruby-operator">:</span> <span class="ruby-keyword kw">self</span>[<span class="ruby-value">0</span>]
+    <span class="ruby-keyword kw">else</span> [<span class="ruby-keyword kw">self</span>[<span class="ruby-value">0</span><span class="ruby-operator">..</span><span class="ruby-value">-2</span>].<span class="ruby-identifier">join</span>(<span class="ruby-value str">&quot;, &quot;</span>), <span class="ruby-keyword kw">self</span>[<span class="ruby-value">-1</span>]].<span class="ruby-identifier">join</span>(<span class="ruby-value str">&quot; and &quot;</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="M000114"></a><b>last=</b>(x)
+  </div>
+  <div class="description">
+  <p>
+Change the last element.
+</p>
+<pre>
+  a = [1,2,5]
+  a.last = 3
+  p a           #=&gt; [1,2,3]
+</pre>
+  </div>
+<div class="sourcecode">
+  <p class="source-link">[ <a href="javascript:toggleSource('M000114_source')" id="l_M000114_source">show source</a> ]</p>
+  <div id="M000114_source" class="dyn-source">
+<pre>
+<span class="ruby-comment cmt"># File lib/facets/core/array/first.rb, line 30</span>
+  <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">last=</span>(<span class="ruby-identifier">x</span>)
+    <span class="ruby-keyword kw">self</span>[<span class="ruby-value">-1</span>] = <span class="ruby-identifier">x</span>
+  <span class="ruby-keyword kw">end</span>
+</pre>
+  </div>
+</div>
+</div>
+<div class="method">
+  <div class="title">
+    <a name="M000109"></a><b>last_index</b>()
+  </div>
+  <div class="description">
+  <p>
+Returns the last index of the array. Returns nil is array has no elements.
+</p>
+<pre>
+  [1,2,3,4,5].last_index  #=&gt; 4
+</pre>
+  </div>
+<div class="sourcecode">
+  <p class="source-link">[ <a href="javascript:toggleSource('M000109_source')" id="l_M000109_source">show source</a> ]</p>
+  <div id="M000109_source" class="dyn-source">
+<pre>
+<span class="ruby-comment cmt"># File lib/facets/core/array/last_index.rb, line 9</span>
+  <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">last_index</span>
+    <span class="ruby-keyword kw">return</span> <span class="ruby-keyword kw">nil</span> <span class="ruby-keyword kw">if</span> <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">length</span> <span class="ruby-operator">==</span> <span class="ruby-value">0</span>
+    <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">length</span> <span class="ruby-operator">-</span> <span class="ruby-value">1</span>
+  <span class="ruby-keyword kw">end</span>
+</pre>
+  </div>
+</div>
+</div>
+<div class="method">
+  <div class="title">
+    <a name="M000102"></a><b>merge!</b>( other )
+  </div>
+<div class="sourcecode">
+  <p class="source-link">[ <a href="javascript:toggleSource('M000102_source')" id="l_M000102_source">show source</a> ]</p>
+  <div id="M000102_source" class="dyn-source">
+<pre>
+<span class="ruby-comment cmt"># File lib/facets/core/array/merge.rb, line 6</span>
+  <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">merge!</span>( <span class="ruby-identifier">other</span> )
+    <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">replace</span>( <span class="ruby-keyword kw">self</span> <span class="ruby-operator">|</span> <span class="ruby-identifier">other</span> )
+  <span class="ruby-keyword kw">end</span>
+</pre>
+  </div>
+</div>
+</div>
+<div class="method">
+  <div class="title">
+    <a name="M000118"></a><b>mid</b>(offset=0)
+  </div>
+  <div class="description">
+  <p>
+Returns the middle element of an array, or the element offset from middle
+if the parameter is given. Even-sized arrays, not having an exact middle,
+return the middle-right element.
+</p>
+<pre>
+  [1,2,3,4,5].mid        #=&gt; 3
+  [1,2,3,4,5,6].mid      #=&gt; 4
+  [1,2,3,4,5,6].mid(-1)  #=&gt; 3
+  [1,2,3,4,5,6].mid(-2)  #=&gt; 2
+  [1,2,3,4,5,6].mid(1)   #=&gt; 5
+</pre>
+<p>
+In other words, If there are an even number of elements the higher-indexed
+of the two center elements is indexed as orgin (0).
+</p>
+  </div>
+<div class="sourcecode">
+  <p class="source-link">[ <a href="javascript:toggleSource('M000118_source')" id="l_M000118_source">show source</a> ]</p>
+  <div id="M000118_source" class="dyn-source">
+<pre>
+<span class="ruby-comment cmt"># File lib/facets/core/array/mid.rb, line 17</span>
+  <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">mid</span>(<span class="ruby-identifier">offset</span>=<span class="ruby-value">0</span>)
+    <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">at</span>( (<span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">length</span> <span class="ruby-operator">/</span> <span class="ruby-value">2</span>) <span class="ruby-operator">+</span> <span class="ruby-identifier">offset</span> )
+  <span class="ruby-keyword kw">end</span>
+</pre>
+  </div>
+</div>
+</div>
+<div class="method">
+  <div class="title">
+    <a name="M000131"></a><b>middle</b>()
+  </div>
+  <div class="description">
+  <p>
+Returns the middle element(s) of an array. Even-sized arrays, not having an
+exact middle, returns a two-element array of the two middle elements.
+</p>
+<pre>
+  [1,2,3,4,5].mid        #=&gt; 3
+  [1,2,3,4,5,6].mid      #=&gt; [3,4]
+</pre>
+<p>
+In contrast to <a href="Array.html#M000118">mid</a> which utilizes an
+offset.
+</p>
+  </div>
+<div class="sourcecode">
+  <p class="source-link">[ <a href="javascript:toggleSource('M000131_source')" id="l_M000131_source">show source</a> ]</p>
+  <div id="M000131_source" class="dyn-source">
+<pre>
+<span class="ruby-comment cmt"># File lib/facets/core/array/middle.rb, line 12</span>
+  <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">middle</span>
+    <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">size</span> <span class="ruby-operator">%</span> <span class="ruby-value">2</span> <span class="ruby-operator">==</span> <span class="ruby-value">0</span>
+      [ <span class="ruby-identifier">at</span>((<span class="ruby-identifier">size</span><span class="ruby-operator">/</span><span class="ruby-value">2</span>)<span class="ruby-operator">-</span><span class="ruby-value">1</span>), <span class="ruby-identifier">at</span>(<span class="ruby-identifier">size</span><span class="ruby-operator">/</span><span class="ruby-value">2</span>) ]
+    <span class="ruby-keyword kw">else</span>
+      <span class="ruby-identifier">at</span>(<span class="ruby-identifier">size</span><span class="ruby-operator">/</span><span class="ruby-value">2</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="M000132"></a><b>pick</b>(n=nil)
+  </div>
+  <div class="description">
+  <p>
+Similar to <a href="Array.html#M000111">at_rand</a>, but will return an
+array of randomly picked exclusive elements if given a number.
+</p>
+  </div>
+<div class="sourcecode">
+  <p class="source-link">[ <a href="javascript:toggleSource('M000132_source')" id="l_M000132_source">show source</a> ]</p>
+  <div id="M000132_source" class="dyn-source">
+<pre>
+<span class="ruby-comment cmt"># File lib/facets/core/array/pick.rb, line 6</span>
+  <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">pick</span>(<span class="ruby-identifier">n</span>=<span class="ruby-keyword kw">nil</span>)
+    <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">n</span>
+      <span class="ruby-identifier">a</span> = <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">dup</span>
+      <span class="ruby-identifier">a</span>.<span class="ruby-identifier">pick!</span>(<span class="ruby-identifier">n</span>)
+    <span class="ruby-keyword kw">else</span>
+      <span class="ruby-identifier">at</span>( <span class="ruby-constant">Kernel</span>.<span class="ruby-identifier">rand</span>( <span class="ruby-identifier">size</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="M000133"></a><b>pick!</b>(n=nil)
+  </div>
+  <div class="description">
+  <p>
+Similar to <a href="Array.html#M000112">at_rand!</a>, but given a number
+will return an array of exclusive elements.
+</p>
+  </div>
+<div class="sourcecode">
+  <p class="source-link">[ <a href="javascript:toggleSource('M000133_source')" id="l_M000133_source">show source</a> ]</p>
+  <div id="M000133_source" class="dyn-source">
+<pre>
+<span class="ruby-comment cmt"># File lib/facets/core/array/pick.rb, line 17</span>
+  <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">pick!</span>(<span class="ruby-identifier">n</span>=<span class="ruby-keyword kw">nil</span>)
+    <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">n</span>
+      <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">n</span> <span class="ruby-operator">&gt;</span> <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">size</span>
+        <span class="ruby-identifier">r</span> = <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">dup</span>
+        <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">replace</span>([])
+        <span class="ruby-identifier">r</span>
+      <span class="ruby-keyword kw">else</span>
+        <span class="ruby-identifier">r</span> = []
+        <span class="ruby-identifier">n</span>.<span class="ruby-identifier">times</span> { <span class="ruby-identifier">r</span> <span class="ruby-operator">&lt;&lt;</span> <span class="ruby-identifier">delete_at</span>( <span class="ruby-constant">Kernel</span>.<span class="ruby-identifier">rand</span>( <span class="ruby-identifier">size</span> ) ) }
+        <span class="ruby-identifier">r</span>
+      <span class="ruby-keyword kw">end</span>
+    <span class="ruby-keyword kw">else</span>
+      <span class="ruby-identifier">delete_at</span>( <span class="ruby-constant">Kernel</span>.<span class="ruby-identifier">rand</span>( <span class="ruby-identifier">size</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="M000124"></a><b>pos</b>(i)
+  </div>
+  <div class="description">
+  <p>
+Returns the positive ordinal index given a cardinal position, 1 to n or -n
+to -1.
+</p>
+<pre>
+  [1,2,3,4,5].pos(1)   #=&gt; 0
+  [1,2,3,4,5].pos(-1)  #=&gt; 4
+</pre>
+  </div>
+<div class="sourcecode">
+  <p class="source-link">[ <a href="javascript:toggleSource('M000124_source')" id="l_M000124_source">show source</a> ]</p>
+  <div id="M000124_source" class="dyn-source">
+<pre>
+<span class="ruby-comment cmt"># File lib/facets/core/array/pos.rb, line 8</span>
+  <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">pos</span>(<span class="ruby-identifier">i</span>)
+    <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">i</span> <span class="ruby-operator">&gt;</span> <span class="ruby-value">0</span>
+      <span class="ruby-keyword kw">return</span> <span class="ruby-identifier">i</span> <span class="ruby-operator">-</span> <span class="ruby-value">1</span>
+    <span class="ruby-keyword kw">else</span>
+      <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">length</span> <span class="ruby-operator">+</span> <span class="ruby-identifier">i</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="M000104"></a><b>rand_index</b>()
+  </div>
+<div class="sourcecode">
+  <p class="source-link">[ <a href="javascript:toggleSource('M000104_source')" id="l_M000104_source">show source</a> ]</p>
+  <div id="M000104_source" class="dyn-source">
+<pre>
+<span class="ruby-comment cmt"># File lib/facets/core/array/rand_index.rb, line 2</span>
+  <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">rand_index</span>
+    <span class="ruby-identifier">rand</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="M000105"></a><b>rand_subset</b>( number=nil, exclusive=true )
+  </div>
+  <div class="description">
+  <p>
+Returns a random subset of an <a href="Array.html">Array</a>. If a
+<em>number</em> of elements is specified then returns that number of
+elements, otherwise returns a random number of elements upto the size of
+the <a href="Array.html">Array</a>.
+</p>
+<p>
+By defualt the returned values are exclusive of each other, but if
+<em>exclusive</em> is set to <tt>false</tt>, the same values can be choosen
+more than once.
+</p>
+<p>
+When <em>exclusive</em> is <tt>true</tt> (the default) and the
+<em>number</em> given is greater than the size of the array, then all
+values are returned.
+</p>
+<pre>
+  [1, 2, 3, 4].rand_subset(1)        #=&gt; [2]
+  [1, 2, 3, 4].rand_subset(4)        #=&gt; [2, 1, 3, 4]
+  [1, 2, 3, 4].rand_subset           #=&gt; [1, 3, 4]
+  [1, 2, 3, 4].rand_subset           #=&gt; [2, 3]
+</pre>
+  </div>
+<div class="sourcecode">
+  <p class="source-link">[ <a href="javascript:toggleSource('M000105_source')" id="l_M000105_source">show source</a> ]</p>
+  <div id="M000105_source" class="dyn-source">
+<pre>
+<span class="ruby-comment cmt"># File lib/facets/core/array/rand_subset.rb, line 22</span>
+  <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">rand_subset</span>( <span class="ruby-identifier">number</span>=<span class="ruby-keyword kw">nil</span>, <span class="ruby-identifier">exclusive</span>=<span class="ruby-keyword kw">true</span> )
+    <span class="ruby-identifier">number</span> = <span class="ruby-identifier">rand</span>( <span class="ruby-identifier">size</span> ) <span class="ruby-keyword kw">unless</span> <span class="ruby-identifier">number</span>
+    <span class="ruby-identifier">number</span> = <span class="ruby-identifier">number</span>.<span class="ruby-identifier">to_int</span>
+    <span class="ruby-comment cmt">#return self.dup if (number &gt;= size and exlusive)</span>
+    <span class="ruby-keyword kw">return</span> <span class="ruby-identifier">sort_by</span>{<span class="ruby-identifier">rand</span>}.<span class="ruby-identifier">slice</span>(<span class="ruby-value">0</span>,<span class="ruby-identifier">number</span>) <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">exclusive</span>
+    <span class="ruby-identifier">ri</span> =[]; <span class="ruby-identifier">number</span>.<span class="ruby-identifier">times</span> { <span class="ruby-operator">|</span><span class="ruby-identifier">n</span><span class="ruby-operator">|</span> <span class="ruby-identifier">ri</span> <span class="ruby-operator">&lt;&lt;</span> <span class="ruby-identifier">rand</span>( <span class="ruby-identifier">size</span> ) }
+    <span class="ruby-keyword kw">return</span> <span class="ruby-identifier">values_at</span>(<span class="ruby-operator">*</span><span class="ruby-identifier">ri</span>)
+  <span class="ruby-keyword kw">end</span>
+</pre>
+  </div>
+</div>
+</div>
+<div class="method">
+  <div class="title">
+    <a name="M000115"></a><b>range</b>(a=nil,z=nil)
+  </div>
+  <div class="description">
+  <p>
+Returns the index range between two elements. If no elements are given,
+returns the range from first to last.
+</p>
+<pre>
+  ['a','b','c','d'].range            #=&gt; 0..3
+  ['a','b','c','d'].range('b','d')   #=&gt; 1..2
+</pre>
+  </div>
+<div class="sourcecode">
+  <p class="source-link">[ <a href="javascript:toggleSource('M000115_source')" id="l_M000115_source">show source</a> ]</p>
+  <div id="M000115_source" class="dyn-source">
+<pre>
+<span class="ruby-comment cmt"># File lib/facets/core/array/range.rb, line 12</span>
+  <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">range</span>(<span class="ruby-identifier">a</span>=<span class="ruby-keyword kw">nil</span>,<span class="ruby-identifier">z</span>=<span class="ruby-keyword kw">nil</span>)
+    <span class="ruby-keyword kw">if</span> <span class="ruby-operator">!</span><span class="ruby-identifier">a</span>
+      <span class="ruby-value">0</span><span class="ruby-operator">..</span><span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">length</span><span class="ruby-operator">-</span><span class="ruby-value">1</span>
+    <span class="ruby-keyword kw">else</span>
+      <span class="ruby-identifier">index</span>(<span class="ruby-identifier">a</span>)<span class="ruby-operator">..</span><span class="ruby-identifier">index</span>(<span class="ruby-identifier">z</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="M000125"></a><b>rotate</b>(n=1)
+  </div>
+  <div class="description">
+  <p>
+Rotates an array&#8217;s elements from back to front n times.
+</p>
+<pre>
+  [1,2,3].rotate      #=&gt; [3,1,2]
+  [3,1,2].rotate      #=&gt; [2,3,1]
+  [3,1,2].rotate      #=&gt; [1,2,3]
+  [1,2,3].rotate(3)   #=&gt; [1,2,3]
+</pre>
+<p>
+A negative parameter reverses the order from front to back.
+</p>
+<pre>
+  [1,2,3].rotate(-1)  #=&gt; [2,3,1]
+</pre>
+  </div>
+<div class="sourcecode">
+  <p class="source-link">[ <a href="javascript:toggleSource('M000125_source')" id="l_M000125_source">show source</a> ]</p>
+  <div id="M000125_source" class="dyn-source">
+<pre>
+<span class="ruby-comment cmt"># File lib/facets/core/array/rotate.rb, line 15</span>
+  <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">rotate</span>(<span class="ruby-identifier">n</span>=<span class="ruby-value">1</span>)
+    <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">dup</span>.<span class="ruby-identifier">rotate!</span>(<span class="ruby-identifier">n</span>)
+  <span class="ruby-keyword kw">end</span>
+</pre>
+  </div>
+</div>
+</div>
+<div class="method">
+  <div class="title">
+    <a name="M000126"></a><b>rotate!</b>(n=1)
+  </div>
+  <div class="description">
+  <p>
+Same as <a href="Array.html#M000125">rotate</a>, but acts in place.
+</p>
+<pre>
+  a = [1,2,3]
+  a.rotate!
+  a  #=&gt; [3,1,2]
+</pre>
+  </div>
+<div class="sourcecode">
+  <p class="source-link">[ <a href="javascript:toggleSource('M000126_source')" id="l_M000126_source">show source</a> ]</p>
+  <div id="M000126_source" class="dyn-source">
+<pre>
+<span class="ruby-comment cmt"># File lib/facets/core/array/rotate.rb, line 25</span>
+  <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">rotate!</span>(<span class="ruby-identifier">n</span>=<span class="ruby-value">1</span>)
+    <span class="ruby-identifier">n</span> = <span class="ruby-identifier">n</span>.<span class="ruby-identifier">to_int</span>
+    <span class="ruby-keyword kw">return</span> <span class="ruby-keyword kw">self</span> <span class="ruby-keyword kw">if</span> (<span class="ruby-identifier">n</span> <span class="ruby-operator">==</span> <span class="ruby-value">0</span> <span class="ruby-keyword kw">or</span> <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">empty?</span>)
+    <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">n</span> <span class="ruby-operator">&gt;</span> <span class="ruby-value">0</span>
+      <span class="ruby-identifier">n</span>.<span class="ruby-identifier">abs</span>.<span class="ruby-identifier">times</span>{ <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">unshift</span>( <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">pop</span> ) }
+    <span class="ruby-keyword kw">else</span>
+      <span class="ruby-identifier">n</span>.<span class="ruby-identifier">abs</span>.<span class="ruby-identifier">times</span>{ <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">push</span>( <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">shift</span> ) }
+    <span class="ruby-keyword kw">end</span>
+    <span class="ruby-keyword kw">self</span>
+  <span class="ruby-keyword kw">end</span>
+</pre>
+  </div>
+</div>
+</div>
+<div class="method">
+  <div class="title">
+    <a name="M000103"></a><b>select!</b>( {|| ...}
+  </div>
+  <div class="description">
+  <p>
+As with select but modifies the <a href="Array.html">Array</a> in place.
+</p>
+<pre>
+  a = [1,2,3,4,5,6,7,8,9,10]
+  a.select!{ |e| e % 2 == 0 }
+  a  #=&gt; [2,4,6,8,10]
+</pre>
+  </div>
+<div class="sourcecode">
+  <p class="source-link">[ <a href="javascript:toggleSource('M000103_source')" id="l_M000103_source">show source</a> ]</p>
+  <div id="M000103_source" class="dyn-source">
+<pre>
+<span class="ruby-comment cmt"># File lib/facets/core/array/select.rb, line 10</span>
+  <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">select!</span>  <span class="ruby-comment cmt"># :yield:</span>
+    <span class="ruby-identifier">reject!</span>{ <span class="ruby-operator">|</span><span class="ruby-identifier">e</span><span class="ruby-operator">|</span> <span class="ruby-keyword kw">not</span> <span class="ruby-keyword kw">yield</span>(<span class="ruby-identifier">e</span>) }
+  <span class="ruby-keyword kw">end</span>
+</pre>
+  </div>
+</div>
+</div>
+<div class="method">
+  <div class="title">
+    <a name="M000127"></a><b>shuffle</b>()
+  </div>
+  <div class="description">
+  <p>
+Randomize the order of an array.
+</p>
+<pre>
+  [1,2,3,4].shuffle  #=&gt; [2,4,1,3]
+</pre>
+  </div>
+<div class="sourcecode">
+  <p class="source-link">[ <a href="javascript:toggleSource('M000127_source')" id="l_M000127_source">show source</a> ]</p>
+  <div id="M000127_source" class="dyn-source">
+<pre>
+<span class="ruby-comment cmt"># File lib/facets/core/array/shuffle.rb, line 11</span>
+  <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">shuffle</span>
+    <span class="ruby-identifier">dup</span>.<span class="ruby-identifier">shuffle!</span>
+    <span class="ruby-comment cmt">#sort_by{Kernel.rand}</span>
+  <span class="ruby-keyword kw">end</span>
+</pre>
+  </div>
+</div>
+</div>
+<div class="method">
+  <div class="title">
+    <a name="M000128"></a><b>shuffle!</b>()
+  </div>
+  <div class="description">
+  <p>
+As with <a href="Array.html#M000127">shuffle</a> but modifies the array in
+place. The algorithm used here is known as a Fisher-Yates shuffle.
+</p>
+<pre>
+  a = [1,2,3,4]
+  a.shuffle!
+  a  #=&gt; [2,4,1,3]
+</pre>
+  </div>
+<div class="sourcecode">
+  <p class="source-link">[ <a href="javascript:toggleSource('M000128_source')" id="l_M000128_source">show source</a> ]</p>
+  <div id="M000128_source" class="dyn-source">
+<pre>
+<span class="ruby-comment cmt"># File lib/facets/core/array/shuffle.rb, line 23</span>
+  <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">shuffle!</span>
+    <span class="ruby-identifier">s</span> = <span class="ruby-identifier">size</span>
+    <span class="ruby-identifier">each_index</span> <span class="ruby-keyword kw">do</span> <span class="ruby-operator">|</span><span class="ruby-identifier">j</span><span class="ruby-operator">|</span>
+      <span class="ruby-identifier">i</span> = <span class="ruby-constant">Kernel</span>.<span class="ruby-identifier">rand</span>(<span class="ruby-identifier">s</span><span class="ruby-operator">-</span><span class="ruby-identifier">j</span>)
+      <span class="ruby-comment cmt">#self[j], self[j+i] = self[j+i], self[j]</span>
+      <span class="ruby-identifier">tmp</span> = <span class="ruby-keyword kw">self</span>[<span class="ruby-identifier">j</span>]
+      <span class="ruby-keyword kw">self</span>[<span class="ruby-identifier">j</span>] = <span class="ruby-keyword kw">self</span>[<span class="ruby-identifier">j</span><span class="ruby-operator">+</span><span class="ruby-identifier">i</span>]
+      <span class="ruby-keyword kw">self</span>[<span class="ruby-identifier">j</span><span class="ruby-operator">+</span><span class="ruby-identifier">i</span>] = <span class="ruby-identifier">tmp</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="M000135"></a><b>store</b>(*args)
+  </div>
+  <div class="description">
+  <p>
+Alias for #[]=
+</p>
+  </div>
+</div>
+<div class="method">
+  <div class="title">
+    <a name="M000121"></a><b>tail</b>()
+  </div>
+  <div class="description">
+  <p>
+Returns an array from second element to last element.
+</p>
+<pre>
+  [1,2,3].tail  #=&gt; [2,3]
+</pre>
+  </div>
+<div class="sourcecode">
+  <p class="source-link">[ <a href="javascript:toggleSource('M000121_source')" id="l_M000121_source">show source</a> ]</p>
+  <div id="M000121_source" class="dyn-source">
+<pre>
+<span class="ruby-comment cmt"># File lib/facets/core/array/head.rb, line 17</span>
+  <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">tail</span>
+    <span class="ruby-identifier">slice</span>(<span class="ruby-value">1</span>,<span class="ruby-identifier">length</span><span class="ruby-operator">-</span><span class="ruby-value">1</span>)
+  <span class="ruby-keyword kw">end</span>
+</pre>
+  </div>
+</div>
+</div>
+<div class="method">
+  <div class="title">
+    <a name="M000110"></a><b>thru</b>( from, to )
+  </div>
+  <div class="description">
+  <p>
+Fetch values from a start index thru an end index.
+</p>
+<pre>
+  [1,2,3,4,5].thru(0,2)  #=&gt; [1,2,3]
+  [1,2,3,4,5].thru(2,4)  #=&gt; [3,4,5]
+</pre>
+  </div>
+<div class="sourcecode">
+  <p class="source-link">[ <a href="javascript:toggleSource('M000110_source')" id="l_M000110_source">show source</a> ]</p>
+  <div id="M000110_source" class="dyn-source">
+<pre>
+<span class="ruby-comment cmt"># File lib/facets/core/array/thru.rb, line 7</span>
+  <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">thru</span>( <span class="ruby-identifier">from</span>, <span class="ruby-identifier">to</span> )
+    <span class="ruby-identifier">a</span> = []
+    <span class="ruby-identifier">i</span> = <span class="ruby-identifier">from</span>
+    <span class="ruby-keyword kw">while</span> <span class="ruby-identifier">i</span> <span class="ruby-operator">&lt;=</span> <span class="ruby-identifier">to</span>
+      <span class="ruby-identifier">a</span> <span class="ruby-operator">&lt;&lt;</span> <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">at</span>(<span class="ruby-identifier">i</span>)
+      <span class="ruby-identifier">i</span> <span class="ruby-operator">+=</span> <span class="ruby-value">1</span>
+    <span class="ruby-keyword kw">end</span>
+    <span class="ruby-identifier">a</span>
+  <span class="ruby-keyword kw">end</span>
+</pre>
+  </div>
+</div>
+</div>
+<div class="method">
+  <div class="title">
+    <a name="M000116"></a><b>to_b</b>()
+  </div>
+  <div class="description">
+  <p>
+Boolean conversion for not empty?
+</p>
+  </div>
+<div class="sourcecode">
+  <p class="source-link">[ <a href="javascript:toggleSource('M000116_source')" id="l_M000116_source">show source</a> ]</p>
+  <div id="M000116_source" class="dyn-source">
+<pre>
+<span class="ruby-comment cmt"># File lib/facets/core/array/to_b.rb, line 5</span>
+  <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">to_b</span>
+    <span class="ruby-operator">!</span> <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">empty?</span>
+  <span class="ruby-keyword kw">end</span>
+</pre>
+  </div>
+</div>
+</div>
+<div class="method">
+  <div class="title">
+    <a name="M000117"></a><b>to_h</b>(arrayed=nil)
+  </div>
+  <div class="description">
+  <p>
+Converts a two-element associative array into a hash.
+</p>
+<pre>
+  a = [ [:a,1], [:b,2] ]
+  a.to_h  #=&gt; { :a=&gt;1, :b=&gt;2 }
+</pre>
+<p>
+If <tt>arrayed</tt> is set it will maintain trailing arrays.
+</p>
+<pre>
+  a = [ [:a,1,2], [:b,3] ]
+  a.to_h(true)  #=&gt; { :a=&gt;[1,2], :b=&gt;[3] }
+</pre>
+<p>
+NOTE: the use of a values parameter has been deprecated because that
+functionality is as simple as:
+</p>
+<pre>
+  array1.zip(array2).to_h
+</pre>
+  </div>
+<div class="sourcecode">
+  <p class="source-link">[ <a href="javascript:toggleSource('M000117_source')" id="l_M000117_source">show source</a> ]</p>
+  <div id="M000117_source" class="dyn-source">
+<pre>
+<span class="ruby-comment cmt"># File lib/facets/core/array/to_h.rb, line 19</span>
+  <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">to_h</span>(<span class="ruby-identifier">arrayed</span>=<span class="ruby-keyword kw">nil</span>)
+    <span class="ruby-keyword kw">unless</span> <span class="ruby-identifier">arrayed</span>
+      <span class="ruby-constant">Hash</span>[<span class="ruby-operator">*</span><span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">flatten</span>]
+    <span class="ruby-keyword kw">else</span>
+      <span class="ruby-identifier">h</span> = {}
+      <span class="ruby-identifier">each</span>{ <span class="ruby-operator">|</span><span class="ruby-identifier">e</span><span class="ruby-operator">|</span> <span class="ruby-identifier">h</span>[<span class="ruby-identifier">e</span>.<span class="ruby-identifier">first</span>] = <span class="ruby-identifier">e</span>.<span class="ruby-identifier">slice</span>(<span class="ruby-value">1</span><span class="ruby-operator">..</span><span class="ruby-value">-1</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="M000134"></a><b>to_hash</b>()
+  </div>
+  <div class="description">
+  <p>
+Converts an array into a hash.
+</p>
+<p>
+This methd is just like <a
+href="Enumerable.html#M000482">Enumerable#to_h</a>. But has been moved in
+order to accomodate associtiave arrays. We use <a
+href="Array.html#M000134">to_hash</a> becasue an <a
+href="Array.html">Array</a> is, in essence, a hash, just with a restricted
+set of keys and maintained order.
+</p>
+<pre>
+  a = [ :a, :b, :c ]
+  a.to_hash  #=&gt; { 0=&gt;:a, 1=&gt;:b, 2=&gt;:c }
+</pre>
+  </div>
+<div class="sourcecode">
+  <p class="source-link">[ <a href="javascript:toggleSource('M000134_source')" id="l_M000134_source">show source</a> ]</p>
+  <div id="M000134_source" class="dyn-source">
+<pre>
+<span class="ruby-comment cmt"># File lib/facets/core/array/to_hash.rb, line 18</span>
+  <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">to_hash</span>
+    <span class="ruby-identifier">h</span> = {}
+    <span class="ruby-identifier">each_with_index</span>{ <span class="ruby-operator">|</span><span class="ruby-identifier">e</span>,<span class="ruby-identifier">i</span><span class="ruby-operator">|</span> <span class="ruby-identifier">h</span>[<span class="ruby-identifier">i</span>] = <span class="ruby-identifier">e</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="M000106"></a><b>unzip</b>(level)
+  </div>
+<div class="sourcecode">
+  <p class="source-link">[ <a href="javascript:toggleSource('M000106_source')" id="l_M000106_source">show source</a> ]</p>
+  <div id="M000106_source" class="dyn-source">
+<pre>
+<span class="ruby-comment cmt"># File lib/facets/core/array/unzip.rb, line 3</span>
+  <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">unzip</span>(<span class="ruby-identifier">level</span>)
+    <span class="ruby-identifier">res</span> = <span class="ruby-constant">Array</span>.<span class="ruby-identifier">new</span>(<span class="ruby-identifier">level</span>, [])
+    (<span class="ruby-value">0</span><span class="ruby-operator">...</span><span class="ruby-identifier">size</span>).<span class="ruby-identifier">each</span> {<span class="ruby-operator">|</span><span class="ruby-identifier">i</span><span class="ruby-operator">|</span>
+      <span class="ruby-identifier">res</span>[<span class="ruby-identifier">i</span> <span class="ruby-operator">%</span> <span class="ruby-identifier">level</span>] <span class="ruby-operator">+=</span> [<span class="ruby-keyword kw">self</span>[<span class="ruby-identifier">i</span>]]
+    }
+    <span class="ruby-identifier">res</span>
+  <span class="ruby-keyword kw">end</span>
+</pre>
+  </div>
+</div>
+</div>
+</div>
+
+  </div>
+
+    </body>
+</html>